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, haga clic en el icono de usuario y seleccione Administrador en el menú desplegable.
- Luego seleccioneAdministrador de la organizaciónen el menú desplegable.
- En la página Administración de la organización, seleccione Seguridaden el panel del menú izquierdo y luego seleccione la pestaña Aprovisionamiento.
- En Crear proveedor de identidad o concesión de API, haga clic en Agregar identidad o API.
-
Seleccione Concesión de API en el menú desplegable.
Las siguientes instrucciones son para una concesión de API. Para un proveedor de identidad, consulte Administrar y aprovisionar usuarios con SCIM.
- Introduce la siguiente información para la concesión de la API:
- En Nombre del cliente, ingrese un nombre que le ayude a identificar esta subvención.
- En Espacio de trabajo, introduce el espacio de trabajo al que se concederá esta subvención.
-
En Nombre de usuario de Workiva, ingrese el nombre de usuario del usuario que necesita la autorizació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, agregue 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.
- Haga clic en Agregar subvención 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:".