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 concesión API:
- En la parte superior derecha, haga clic en el icono de usuario y seleccione Admin en el menú desplegable.
- A continuación, seleccione Organization admin en el menú desplegable.
- En la página Organization Admin, seleccione Security en el panel izquierdo del menú y, a continuación, seleccione la pestaña Provisioning.
- En Create Identity Provider or API Grant, haga clic en Add Identity or API.
-
Seleccione API Grant en el menú desplegable.
Las siguientes instrucciones son para una subvención API. Para un proveedor de identidades, consulte Manage and provision users with SCIM.
- Introduce la siguiente información para la concesión de la API:
- En Nombre del cliente, introduzca 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 Workiva Username, introduzca el nombre de usuario del usuario que necesita la subvención para la API.
Sólo este usuario puede ver el secreto de esta concesión de API en Mi perfil > Seguridad.Nota: Por motivos de seguridad, el cambio del nombre de usuario de Workiva 1 invalida el secreto actual, y sólo 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, añada Spreadsheets (Read) y Spreadsheets (Write) para que el usuario pueda acceder a las hojas de cálculo y editarlas. - 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 Add Grant 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:".