# 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.

> [!NOTA] **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.

>[!Example] 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.                                                                                                                                     |

>[!Caution] 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

1. Acesse o formulário **Integrações OIDC** através do caminho: Sistema > Configurações > Integrações > Integrações OIDC;
2. Clique no botão **Novo** para cadastrar uma nova plataforma;
3. 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;
     
4. 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.
	  
5. 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. 

>[!CAUTION] Importante:
>O e-mail do usuário precisa ser o mesmo no provedor de identidade e no sistema, através do cadastro do [[formulario usuarios|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.

>[!info] 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

## Leia Também
- [[integracoes|Integrações]]
- [[integracoes oidc|Integrações OIDC]]
- [[formulario usuarios|Usuários]]