Centro de suporte da Workiva

Na Workiva, gerar um token de acesso (especificamente um token de portador OAuth2) é um processo de duas etapas: primeiro você cria uma API Grant para obter credenciais e, em seguida, usa essas credenciais para solicitar o token real.

1. Você deve criar uma concessão de API

Importado: Você deve ser dono do espaço de trabalho|workspace para executar esta etapa.

Para obter um Client ID & Secret (ID e segredo do cliente):

1. Clique no ícone de sua ID no canto superior direito da página da Workiva e selecione Configurações do espaço de trabalho/workspace.
   
2. Selecione a guia Security e, em seguida, clique em Create API Grant.
   
3. Na página Update Grant , preencha os seguintes campos:
   
   1. Insira um nome de cliente e o nome de usuário Workiva em nome do qual você concederá o subsídio.
   2. Selecione "OAuth2 Client Credentials" (Credenciais de cliente OAuth2) como o tipo de cliente .
   3. Selecione os escopos necessários (permissões) para os pontos de extremidade da API que você planeja usar.
   4. Defina a data Expires.
   5. A menos que especificamente exigido pela sua organização, você pode ignorar o campo Ip Allowlist.
   6. Clique em Add Grant.

Importante: Copie o Client ID e o Client Secret imediatamente, pois o segredo não será mostrado novamente.

2. Recuperar o token do portador

Depois de obter suas credenciais, você deve trocá-las por um token de acesso de curta duração fazendo uma solicitação POST para o serviço Workiva IAM.

• Ponto de extremidade: https://api.app.wdesk.com (o padrão é para os EUA; outras regiões têm pontos de extremidade diferentes).
• Cabeçalhos: Defina Content-Type para application/x-www-form-urlencoded.
• Parâmetros do corpo:
  • grant_type: client_credentials
  • client_id: [Seu ID de cliente]
  • client_secret: [Seu segredo de cliente]
• Expiração: Os tokens de portador da Workiva são normalmente válidos por 10 minutos. Você deve atualizá-los periodicamente para processos de longa duração.

Tokens SEC EDGAR Next

Se você estiver gerando tokens especificamente para arquivamento na SEC (EDGAR Next), eles são diferentes dos tokens de API padrão:

• Esses tokens (Filer API Token e User Token) são criados no painel EDGAR Filer Management da SEC .
• Uma vez obtidos, você pode gerenciá-los na Workiva em SEC Reporting > Manage EDGAR Next Tokens.