Este artículo es para:
- Administradores de seguridad de Org
- Administradores del espacio de trabajo Org
- Propietarios de espacios de trabajo
Para acceder a cualquier API de Workiva, los usuarios necesitarán una concesión de API para su autorización. Una vez creada una concesión de API para un usuario, podrá editar los detalles de la concesión o eliminarla. Sin embargo, sólo el usuario podrá ver el secreto de su subvención regenerando la subvención en su perfil de usuario.
Crear una subvención API
Para empezar a crear una concesión de API:
- En Configuración del espacio de trabajo, vaya a la pestaña Seguridad y seleccione Crear concesión de API.
- Introduzca la siguiente información para la subvención API:
-
- Para Nombre del cliente, introduzca un nombre que le ayude a identificar esta subvención.
- En Espacio de trabajo, introduzca el espacio de trabajo al que se atribuirá esta subvención.
- Para Workiva Username, introduzca el nombre de usuario del usuario que necesita la subvención para la API. Sólo este usuario podrá ver el secreto de esta concesión de API en Mi perfil > Seguridad.
Nota: Por motivos de seguridad, si más adelante cambia el Nombre de usuario de Workiva, el secreto actual dejará de ser válido, y sólo el nuevo usuario tendrá acceso al nuevo secreto.
- Para Scopes, especifique la(s) acción(es) que el sistema puede realizar en nombre del usuario.
Nota: Consulte nuestra discusión Understanding API Grant Scopes para ver más información sobre los ámbitos.
- En Expires, establezca cuándo debe caducar la concesión, en función de las políticas y preferencias de seguridad de su organización.
- Si es necesario, introduzca una lista de direcciones IP separadas por comas en IP Allowlist para la concesión.
- Haga clic en Agregar subvención para finalizar.
Gestión de subvenciones API
Puede editar los detalles de una subvención específica o eliminarla haciendo clic en la acción correspondiente en el menú desplegable Acciones .
Ver API grant secret
Sólo el usuario especificado en los Detalles de la concesión de la API puede ver el secreto de su concesión. Para ello, vaya a Mi perfil, seleccione la pestaña Seguridad y, a continuación, haga clic en Regenerar en el menú desplegable Acciones situado junto a la concesión. El usuario sólo puede ver el secreto una vez, por lo que tendrá que copiarlo en un lugar seguro. Si pierden el secreto, tendrán que regenerarlo de nuevo.
Nota: El secreto empieza por "wk_secret:"