Centro de soporte de Workiva

En Workiva, generar un token de acceso (concretamente un token de portador OAuth2) es un proceso de dos pasos: primero creas una Concesión de API para obtener credenciales y, a continuación, utilizas esas credenciales para solicitar el token real.

1. Crear una Concesión de API

Importante: Debes ser propietario del espacio de trabajo para realizar este paso.

Para obtener un Id de cliente y Secreto:

1. Haz clic en el icono de tu ID situado en la esquina superior derecha de la página de Workiva y, a continuación, selecciona «Configuración del espacio de trabajo ».
   
2. Selecciona la pestaña «Seguridad » y, a continuación, haz clic en «Crear autorización de API ».
   
3. En la página «Actualizar subvención », rellena los siguientes campos:
   
   1. Introduce el nombre del cliente y el nombre de usuario de Workiva en cuyo nombre se realizará la concesión.
   2. Selecciona «Credenciales de cliente OAuth2» como tipo de cliente .
   3. Selecciona los ámbitos ( permisos) necesarios para los puntos finales de la API que tengas previsto utilizar.
   4. Establece la fecha de caducidad .
   5. A menos que tu organización lo exija expresamente, puedes ignorar el campo «Lista de direcciones IP permitidas ».
   6. Haz clic en «Añadir subvención ».

Importante: Copia inmediatamente el ID de cliente y el secreto de cliente, ya que el secreto no volverá a mostrarse.

2. Recuperar el Token de portador

Una vez que tengas tus credenciales, debes canjearlas por un token de acceso de corta duración enviando una solicitud POST al servicio IAM de Workiva.

• Punto final: https://api.app.wdesk.com (este es el valor predeterminado para EE. UU.; otras regiones tienen puntos finales diferentes ).
• Tipo de contenido: Establece el campo «Content-Type» en «application/json ».

• 

• Encabezados: Añadir X-Version : 01-01-2026

• 

• Valores del formulario:
  • grant_type : client_credentials
  • client_id :[Your Client ID]
  • client_secret :[Your Client Secret]
  • Ámbito de aplicación : Cadenas

• 

• Caducidad: Los tokens al portador de Workiva suelen tener una validez de 10 minutos. Debes actualizarlas periódicamente para los procesos de larga duración.

Tokens SEC EDGAR Next

Si estás generando tokens específicamente para la presentación de documentos ante la SEC (EDGAR Next) , estos son diferentes de los tokens estándar de la API:

• Estos tokens (el token de la API de Filer y el token de usuario) se crean en el panel de control de gestión de Filer de EDGAR de la SEC.
• Una vez obtenidos, puedes gestionarlos en Workiva en Informes SEC > Gestionar tokens EDGAR Next.