Centro de suporte da Workiva

Este artigo é para:

• Administradores de segurança da organização

Criar uma concessão de API

Para acessar qualquer API da Workiva, os usuários precisarão de uma concessão de API para autorização. Como Org Security Admin, se você criar uma concessão de API para um usuário, poderá editar os detalhes da concessão ou excluir a concessão. No entanto, somente o usuário poderá visualizar o segredo de sua concessão ao regenerar a concessão em seu perfil de usuário.

Para começar a criar uma concessão de API:

1. No canto superior direito, clique no ícone do usuário e selecione Admin no menu suspenso.
2. Em seguida, selecioneAdministrador da organizaçãona lista suspensa.
   
3. Na página Administração da Organização, selecione Segurançano painel do menu à esquerda e, em seguida, selecione a guia Provisionamento.
   
4. Em Criar provedor de identidade ou concessão de API, clique em Adicionar identidade ou API.
   

5. Selecione Concessão de API no menu suspenso.
   

   As instruções a seguir são para uma concessão de API. Para um provedor de identidade, consulte Gerenciar e provisionar usuários com SCIM.

6. Digite as seguintes informações para a concessão da API:
   • Em Nome do Cliente, insira um nome que o ajudará a identificar esta concessão.
   • Em Workspace, insira o espaço de trabalho|workspace ao qual essa concessão será atribuída.

   • Em Nome de usuário Workiva, insira o nome de usuário do usuário que precisa da permissão para a API.
     Somente este usuário pode visualizar o segredo desta concessão de API em Meu perfil > Segurança.

     Nota: Por motivos de segurança, alterar o nome de usuário do Workiva invalida o segredo atual e somente o novo nome de usuário terá acesso ao novo segredo.

   • Em Escopos, especifique a(s) ação(ões) que o sistema pode realizar em nome do usuário.
     Por exemplo, para a API de Planilhas, adicione Planilhas (Leitura) e Planilhas (Gravação) para que o usuário possa acessar e editar planilhas.
   • Em Expires, defina quando a concessão deve expirar, com base nas políticas e preferências de segurança de sua organização.
   • (Opção) Você pode inserir uma lista separada por vírgulas de endereços IP na IP Allowlist para a concessão.
     
7. Clique em Adicionar Subsídio para concluir.

Gerenciar concessões de API

Você pode editar os detalhes de uma concessão específica ou excluir uma concessão clicando na respectiva ação na lista suspensa Actions para essa concessão.

Exibir segredo de concessão da API

Para exibir o segredo da API, 

1. No canto superior direito, clique no ícone do usuário e selecione My profile na lista suspensa.
   
2. Clique na guia Security.
3. Localize a concessão da API para a qual você deseja obter o segredo.
4. Clique em Regenerate na lista suspensa Actions ao lado da concessão.

Notas importantes

• Somente o usuário especificado nos detalhes da concessão da API pode exibir o segredo da concessão.  
• Você só pode exibir o segredo uma vez, portanto, precisará copiar o segredo em um local seguro.
  Se você perder o segredo, precisará gerá-lo novamente e, em seguida, preencher todos os locais que o exigem com o novo segredo.
• Dica: O segredo começa com "wk_secret:"

O que vem a seguir? 

• Gerenciar e provisionar usuários com o SCIM
• Gerenciar as configurações de retenção de atividades
• Criar e gerenciar concessões de API nas configurações do workspace