Este artículo es para:
- Administradores de seguridad de la organización
Crear una concesión API
Para acceder a cualquier API de Workiva, los usuarios necesitarán una concesión de API para su autorización. Como Administrador de seguridad de la organización, creas una concesión de API para un usuario, podrás editar los detalles de la concesión o eliminarla. Sin embargo, solo el usuario podrá ver el secreto de su concesión regenerándola en su perfil de usuario.
Para empezar a crear una subvención API:
- En la parte superior derecha, haz clic en el ícono de usuario y selecciona Admin del menú desplegable.
- Luego selecciona Administrador de la organización del menú desplegable.
- En la página Administrador de la organización, selecciona Gestión de identidades y acceso > Identidades > Aprovisionamiento.
- En Crear proveedor de identidades o Concesión de API, haz clic en Agregar identidad o API.
-
Selecciona Concesión de API en el menú desplegable.
Las siguientes instrucciones son para una Concesión de API. Para un Proveedor de identidades, consulta Administrar y aprovisionar usuarios con SCIM.
- Introduce la siguiente información para la concesión de la API:
- En Nombre del cliente, ingresa un nombre que te ayude a identificar esta concesión.
- En Espacio de trabajo, introduce el espacio de trabajo al que se concederá esta subvención.
-
En Nombre de usuario de Workiva, ingresa el nombre de usuario del usuario que necesita la concesión para la API.
Solo este usuario puede ver el secreto de esta concesión de API en Mi perfil > Seguridad.Nota: Por motivos de seguridad, cambiar el Nombre de usuario de Workiva invalida el secreto actual, y solo el nuevo nombre de usuario tendrá acceso al nuevo secreto.
- En Ámbitos, especifica la(s) acción(es) que el sistema puede realizar en nombre del usuario.
Por ejemplo, para la API de Hojas de cálculo, agrega Hojas de cálculo (Lectura) y Hojas de cálculo (Escritura) para que el usuario pueda acceder y editar hojas de cálculo. - En Caduca en, establece cuándo debe caducar la concesión, según las políticas y preferencias de seguridad de tu organización.
- (Opcional) Introduce una lista de direcciones IP separadas por comas en la Lista de direcciones IP permitidas para la concesión.
- Haz clic en Concesión de API para finalizar.
Gestionar subvenciones API
Puedes editar los detalles de una concesión específica o eliminar una concesión haciendo clic en la acción respectiva en el menú desplegable Acciones para esa concesión.
Ver el secreto de concesión de la API
Para ver el secreto de la API,
- En la parte superior derecha, haz clic en el icono de usuario y selecciona Mi perfil en el menú desplegable.
- Haz clic en la pestaña Seguridad.
- Localiza la concesión de API para la que quieres el secreto.
- Haz clic en Regenerar en el menú desplegable Acciones situado junto a la concesión.
Notas importantes
- Solo el usuario especificado en los detalles de la concesión de API puede ver el secreto de su concesión.
- Solo puedes ver el secreto una vez, por lo que tendrás que copiarlo en un lugar seguro.
Si pierdes el secreto, tendrás que regenerarlo y, a continuación, rellenar todos los lugares que lo requieran con el nuevo secreto. - Consejo: El secreto comienza por "wk_secret:".