Integrações OIDC
Introdução
O OpenID Connect (OIDC) é um protocolo de autenticação e autorização. Ele permite que aplicativos e serviços verifiquem a identidade de um usuário final com base na autenticação realizada por um servidor de autorização, bem como obtenham informações básicas sobre o perfil do usuário. A utilização do OpenID Connect tem como intuito autenticar a identidade de um usuário e permitir o acesso a aplicativos e APIs.
Acesso à Configuração
Caminho: Configurações > Integrações > Integrações OIDC
Requisitos de Uso
Para utilizar esta ferramenta, é necessário utilizar provedores de identidade compatíveis com o método de autenticação com o sistema.
Provedores de indentidade compatíveis:
- Google OIDC;
- Microsoft OIDC.
Entrega de Valor
A integração OIDC oferece diversos benefícios:
- Autenticação única entre diferentes aplicações;
- Maior segurança na autenticação de usuários;
- Simplificação do processo de login para os usuários finais;
- Controle centralizado de acesso e permissões.
Estrutura do Formulário
A integração está estruturada principalmente no formulário Integrações OIDC, que está organizado em uma grid distribuída em linhas e colunas com as informações de todas as integrações de OIDC. Este formulário permite também o cadastro, edição e deleção de integrações.
Campos Obrigatórios
| Campo | Descrição |
|---|---|
| ID | Identificador único para a integração, gerado automaticamente pelo sistema |
| Descrição | Texto para descrever a finalidade ou características da integração. |
| Provider URL | URL do provedor de identidade para autenticação OIDC. A URL é usada pelo sistema para localizar automaticamente os endpoints de autenticação e as configurações OIDC do provedor. |
| Client ID | Identificador do cliente registrado no provedor de identidade OIDC, possui estrutura de token. |
| Client Secret | Chave (senha) utilizado pelo cliente para autenticação com o provedor OIDC, possui estrutura de token. |
| Status | Indica se a integração está ativa ou inativa. |
Atenção:
O sistema permite somente uma integração de OIDC ativa. Portanto, ao cadastrar novas integrações, inative os cadastros anteriores.
Configuração da Integração
Passo 1: Cadastro da integração
- Acesse o formulário Integrações OIDC através do caminho: Sistema > Configurações > Integrações > Integrações OIDC;
- Clique no botão Novo para cadastrar uma nova plataforma;
- Preencha os campos obrigatórios:
- Descrição: insira uma breve descrição para identificação da integração;
- Provider URL: insira a URL do provedor de identidade. Utilize o endereço do provedor;
- Client ID e Client Secret: dados coletados no console da plataforma que está utilizando;
- Defina o status como Ativo;
- O campo Status determina se a integração está ativa ou não. É importante ressaltar que somente uma integração pode estar ativa quando existe mais de um cadastro.
- Defina o status como ativo apenas após configurar corretamente a URL do provedor e as credenciais.
- Clique em Salvar para validar e concluir o cadastro da integração.
Passo 2: Teste de Autenticação
Após salvar a integração, realize testes para garantir que a autenticação de acesso esteja operando corretamente.
Tendo a integração ativa, uma opção de acesso nova será apresentada na tela de login ao IXC Provedor, através da opção SSO Login.
Deslogue do sistema e acesse novamente através do SSO.
Importante:
O e-mail do usuário precisa ser o mesmo no provedor de identidade e no sistema, através do cadastro do Usuário.
Considerações Finais
A integração OIDC proporciona uma camada adicional de segurança e conveniência para o processo de autenticação. É fundamental manter as configurações atualizadas e seguir as melhores práticas de segurança ao implementar esta integração.
Atenção:
Lembre-se de sempre validar os tokens recebidos e implementar o logout adequadamente para garantir a segurança dos usuários e da aplicação.
Etiquetas
Integracao OIDC Autenticacao SSO
