Pré-requisitos e Configuração
Pré-requisitos e Configuração
Antes de configurar seu provedor de identidade, complete os pré-requisitos abaixo. Seu representante da Deque pode ajudar a provisionar a assinatura SCIM e gerar sua chave API.
Pré-requisitos
Assinatura SCIM
Sua empresa com conta axe deve ter uma Assinatura SCIM ativa. Sem ela, as solicitações SCIM retornam:
402 "Subscription required"Entre em contato com seu representante da Deque para adicionar a assinatura SCIM à sua empresa.
O SCIM funciona juntamente com o Single Sign-On. Quando o SCIM provisiona um usuário nova, a conta é ligada ao provedor de identidade de sua organização para que o usuário possa entrar.
Gerando uma chave API SCIM
Seu provedor de identidade autentica-se no axe usando uma Chave API SCIM com escopo para sua empresa.
- Faça login no Portal de Conta axe como administrador.
- Navegue até Configurações > Gerenciar Chaves API.
- Gere uma Chave API SCIM nova.
- Copie a chave e armazene-a com segurança — você deve inseri-la no conector SCIM do seu provedor de identidade.
Trate a chave API como uma senha. Compartilhe-a apenas através de um canal seguro (por exemplo, o gerenciador de segredos da sua organização), nunca em e-mail ou chat em texto simples. Se uma chave for exposta, revogue-a e gere uma nova.
URL Base
Use o URL base para a sua região ou instância privada:
| Ambiente | URL Base |
|---|---|
| EUA (SaaS) | https://axe.deque.com |
| Paris (SaaS) | https://axe-eu.deque.com |
| Austrália (SaaS) | https://axe-au.deque.com |
| Frankfurt (SaaS) | https://axe-frankfurt.deque.com |
| Nuvem privada / on-premises | URL da sua instância dedicada |
Os endpoints SCIM são servidos sob o caminho /api/scim/v2 — por exemplo:
https://axe.deque.com/api/scim/v2/UsersAutenticação
Inclua a chave API em todas as solicitações. Ambos os seguintes são aceitos:
# Preferred
-H "X-API-Key: <API_KEY>"
# Also accepted (with or without a "Bearer " prefix)
-H "Authorization: <API_KEY>"Próximo
Uma vez que os pré-requisitos sejam atendidos e você tenha sua chave API e URL base, continue para Configurando Seu Provedor de Identidade.