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 esta etapa.

Para obtener un Id de cliente y Secreto:

1. Haz clic en el icono de tu ID en la esquina superior derecha de la página 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 concesión de API.
   
3. En la página Actualizar concesión , completa los siguientes campos:
   
   1. Introduce un Nombre de cliente y el Nombre de usuario de Workiva en cuyo nombre actuará la subvención.
   2. Selecciona "Credenciales de cliente de OAuth2" como el Tipo de cliente.
   3. Selecciona los Ámbitos de : (permisos) requeridos para los puntos finales de la API que piensas utilizar.
   4. Establece la fecha Caduca.
   5. A menos que tu organización lo requiera específicamente, puedes ignorar el campo Lista de direcciones IP permitidas.
   6. Haz clic en Agregar concesión .

Importante: Copia el Id de cliente y el Secreto de cliente inmediatamente, ya que el secreto no se volverá a mostrar.

2. Recuperar el Token de portador

Una vez que tengas tus credenciales, debes intercambiarlas por un código de acceso de corta duración realizando una solicitud POST al servicio Workiva IAM.

• Punto final: https://api.app.wdesk.com (es el predeterminado para EE.UU.; otras regiones tienen puntos finales diferentes).
• Encabezados: Establece Content-Tipo de a application/x-www-form-urlencoded.
• Parámetros del cuerpo:
  • grant_type: client_credentials
  • client_id: [Tu Id de cliente]
  • client_secret: [Tu Secreto de cliente]
• Caducidad: Los tokens de portador Workiva suelen ser válidos durante 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 ante la SEC (EDGAR Next), éstos son diferentes de los tokens API estándar:

• Estos tokens (Filer API Token y User Token) se crean en el panel EDGAR Filer Management de la SEC.
• Una vez obtenidos, puedes gestionarlos en Workiva en Informes SEC > Gestionar tokens EDGAR Next.