Criar um token de API
Seu token de API conecta uma integração aos dados da sua organização. Crie e gerencie o token na sua conta IRIS Cloud.
Crie um token no IRIS Cloud#
Entre no IRIS Cloud
Use sua conta existente no ambiente ao qual deseja se conectar.
Abra a conta de usuário (User Account)
Encontre a seção IRIS Cloud API Tokens. Abrir a conta de usuário no IRIS Cloud ↗
Conta do IRIS Cloud sem tokens de API. Abrir imagem em tamanho original ↗ Selecione Create Token (Criar token)
Dê ao token um nome único e fácil de reconhecer, como Integração de produção. Opcionalmente, adicione uma descrição para identificar o sistema que irá usá-lo.
Janela Create Token com campos de nome, descrição opcional e validade. Abrir imagem em tamanho original ↗ Escolha a validade e crie o token
Selecione 30, 90, 180 ou 365 dias, ou Never (Nunca). Clique em Create (Criar) para gerar o token.
Opções de validade: Never, 30, 90, 180 ou 365 dias. Abrir imagem em tamanho original ↗ 
Formulário preenchido, pronto para criar o token. Abrir imagem em tamanho original ↗
Copie antes de fechar#
Em Token Created (Token criado), selecione Copy Token (Copiar token) e armazene-o no gerenciador de segredos ou na configuração protegida do ambiente da sua integração.
Use seu token no guia rápido ou cole-o em Authorize na referência da API.
Gerencie seus tokens#
A tabela da conta mostra nome, descrição, data de criação, último uso, validade e status de cada token. Sua organização pode ter até três tokens ativos.
Se atingir o limite, revise suas integrações e revogue um token que não seja mais necessário antes de criar outro. Um token com data de validade deixa de funcionar quando expira.
Revogue ou substitua um token#
Na tabela de tokens de API, selecione a ação de revogar o token, revise a confirmação e escolha Revoke Token (Revogar token). A revogação não pode ser desfeita, e as integrações que usam esse token deixarão de funcionar.
Ao substituir um token, crie o novo primeiro se houver espaço entre os tokens ativos. Atualize e verifique a integração e, depois, revogue o token antigo. Se todas as vagas estiverem ocupadas, planeje a substituição antes de revogar um token em uso.