--- title: "Gerenciar provedores OpenID" slug: "how-to-manage-openid-providers" updated: 2026-11-06T19:38:36Z published: 2026-11-06T19:38:36Z canonical: "docs.senhasegura.io/how-to-manage-openid-providers" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.senhasegura.io/llms.txt > Use this file to discover all available pages before exploring further. # Gerenciar provedores OpenID Neste documento, você encontra um guia passo a passo sobre como adicionar ou remover provedores OpenID no Segura™. ## Caminho para acesso 1. No Segura™, na barra de navegação, passe o mouse sobre o **Menu de produtos** e selecione **Configurações**. 2. No menu lateral, selecione **Autenticação > OpenID > Provedores**. Atenção Para que a integração via OpenID Connect funcione corretamente com o Segura™, é necessário garantir que os seguintes *scopes* estejam habilitados no provedor de identidade (IdP): - `openid` - `email` - `profile` Esses *scopes* são essenciais para que a plataforma Segura™ possa identificar e autenticar o usuário corretamente. Em ambientes mais restritivos, pode ser necessário solicitar a liberação explícita desses *scopes* ao time responsável pela gestão do SSO. ## Adicionar provedor Info - Este campo é obrigatório apenas se os campos em URL dos endpoints **não forem preenchidos**. O usuário deve preencher ao menos um dos dois campos disponíveis: OpenID endpoint configuration ou URL dos demais endpoints. Caso o campo URL dos demais endpoints não seja preenchido, torna-se indispensável que o usuário preencha o campo OpenID endpoint configuration para garantir a correta configuração dos serviços. - Atente-se ao fato de que cada provedor irá requerer informações específicas, assim, sempre que for necessário maiores informações, verifique as configurações do provedor. 1. Na página do relatório **Provedores**, clique no botão **Adicionar**. 2. Na tela **Cadastro de provider**: 3. **Tipo**: no menu suspenso, selecione o tipo de provedor OpenID que será utilizado. 4. **Ativo**: selecione o status do provedor OpenID no momento da criação. Por padrão, sempre é selecionado como **Sim**. 5. **Ambiente**: selecione o ambiente em que o provedor OpenID vai estar. 6. **Provider Name:** nome do provedor que será cadastrado. 7. **Ícone (jpg ou png - máximo 200kb):** área de upload do seu ícone personalizado para o provedor. 8. **ID do cliente**: insira o client ID para conexão. Esse ID é entregue pelo provedor OpenID no momento do cadastro de uma nova aplicação. 9. **Client secret**: selecione o secret do provedor de autenticação OpenID. Esse secret é entregue pelo provedor OpenID no momento do cadastro de uma nova aplicação. 10. **Nome de usuário preferido**: insira o atributo do OpenID que será utilizado como identificador de usuário, como por exemplo, `email`. 11. **Domínio ou IP público para URL de redirecionamento**: insira o domínio ou endereço IP público do Segura™. É usado pelo provedor de OpenID para redirecionar o usuário de volta à sua aplicação após a autenticação. 12. **URL de redirecionamento (Redirect URL):** insira o endpoint específico na sua aplicação para o qual o provedor OpenID irá redirecionar o usuário após a autenticação. 13. **Comentários**: campo para adicionar notas ou observações adicionais sobre a configuração. 3. Na seção **Configuração dos endpoints**: 3. **OpenID endpoint configuration**: insira o endpoint que configura o OpenID. Esta é a URL base fornecida pelo provedor OpenID. Esta URL descreve os endpoints necessários para interações OpenID. Esta configuração automatiza a descoberta dos endpoints de forma geral. 4. Na seção **URL dos demais endpoints**: 3. **Endpoint de autorização:** insira a URL disponibilizada pelo provedor OpenID, usada pela aplicação para enviar solicitações de autorização. 4. **Token endpoint**: insira a URL disponibilizada pelo provedor OpenID, para onde a aplicação envia solicitações de troca do código de autorização por um token de acesso. 5. **Userinfo endpoint:** insira a URL disponibilizada pelo provedor OpenID, pela qual a aplicação pode solicitar informações do perfil do usuário autenticado, utilizando o token de acesso. 5. Na seção **Configurações extras do provedor**: 3. **Endpoint JWK (obrigatório se não existir no endpoint OpenID)**: insira o endpoint onde a aplicação deverá obter as chaves públicas do provedor OpenID para validar a assinatura do token de acesso. Esse campo é obrigatório se essas chaves não estiverem disponíveis no endpoint de configuração do OpenID. 4. **Issuers adicionais (separados por vírgula):** insira a lista de emissores (issuers) adicionais que são aceitos pela aplicação. Útil quando a aplicação precisa suportar múltiplos provedores OpenID. 6. Opcional: configure a seção **Configuração de autorização por dispositivo** para permitir que os usuários façam login no Terminal Proxy e no RDP Proxy por meio deste provedor a partir de um segundo dispositivo. Para entender como o fluxo funciona, consulte [Autorização de dispositivo](/v4-2/docs/pt/about-device-authorization). O Segura™ exige o client ID, o client secret e os 3 endpoints quando a autorização de dispositivo está habilitada em um provedor ativo com o ambiente **Local**. Se algum estiver faltando, o Segura™ não salva o provedor e mostra uma mensagem que lista os campos obrigatórios. A autorização de dispositivo usa somente provedores ativos com o ambiente **Local**. Um provedor com o ambiente **Domum Remote Access** nunca é usado. A autorização de dispositivo usa um único provedor. Se mais de um provedor Local ativo estiver com ela habilitada, o Segura™ avisa ao salvar e informa qual provedor está em uso. A autorização de dispositivo identifica o usuário comparando o valor da claim definida em **Nome de usuário preferido** com o nome de usuário de um usuário ativo do Segura™. Para contas do Microsoft Entra ID sem endereço de email, defina **Nome de usuário preferido** como `preferred_username`. Depois, faça o nome de usuário do Segura™ corresponder ao nome principal do usuário (UPN). Atenção Quando a autorização de dispositivo está habilitada e funcionando, o Terminal Proxy e o RDP Proxy exigem que todo usuário que se conecta com um cliente faça login por meio dela, inclusive usuários locais. O Database Proxy não usa a autorização de dispositivo. Sessões que você abre pelo portal web do Segura™ usam a autenticação do portal web. Se a autorização de dispositivo estiver desabilitada ou não puder ser iniciada, os proxies voltam à autenticação por nome de usuário e senha com o MFA do Segura™. O Segura™ validou a autorização de dispositivo com o Microsoft Entra ID. - **Habilitar autorização de dispositivo**: habilite a autorização de dispositivo para este provedor. - **Nome de usuário para autorização por dispositivo**: insira o client ID da aplicação registrada para a autorização de dispositivo. Deixe em branco para usar o **ID do cliente** do provedor. - **Senha para autorização por dispositivo**: insira o client secret dessa aplicação. Deixe em branco para usar o **Client secret** do provedor. - **URL do endpoint de autorização de dispositivo**: insira a URL do endpoint de autorização de dispositivo do provedor de identidade. - **URL do endpoint de token**: insira a URL do endpoint de token do provedor de identidade. - **Url do endpoint de informações do usuário**: insira a URL do endpoint de informações do usuário do provedor de identidade. 7. Clique em **Salvar**. ## Atualizar provider Para atualizar as informações de um provedor previamente cadastrado, siga estes passos: 1. No Segura™, na barra de navegação, passe o mouse sobre o **Menu de produtos** e selecione **Configurações**. 2. No menu lateral, selecione **Autenticação > OpenID > Provedores**. 3. No relatório Provedores, identifique o registro que você deseja atualizar, clique no botão **Ações** e selecione **Editar**. 4. Atualize as informações necessárias e clique em **Salvar**. Info Caso o client_secret não seja alterado, a informação atual será mantida. ## Visualizar detalhes do provider Para visualizar detalhes do provedor, siga estes passos: 1. No relatório Provedores, identifique o registro que você deseja atualizar, clique no botão **Ações** e selecione **Detalhes do provider**. 2. A janela **Cadastro de provider** será aberta em modo de visualização. 3. Você poderá visualizar diversos detalhes do provedor cadastrado nessa janela. Tais como: *OpenID endpoint configuration, Endpoint de autorização, Userinfo endpoint, URL de redirecionamento, Token endpoint* e *Comentários*. 4. Para visualizar uma informação por vez, clique no ícone do olho ao lado do campo de texto de cada detalhe. ## Excluir um provider 1. No relatório Provedores, identifique o registro que você deseja atualizar, clique no botão **Ações** e selecione **Desativar**. 2. No modal de confirmação, clique em **Sim** para inativar o provider.