Usando o painel Autenticação pessoal

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 3 min. de leitura
  • Use suas credenciais pessoais para se conectar a integrações de terceiros. Visualize, autentique, revogue e renove suas autenticações pessoais por meio de uma interface simplificada e consolidada.

    O painel Autenticação pessoal fornece uma maneira simplificada de gerenciar suas integrações de autenticação pessoal. Com a autenticação pessoal, vários usuários podem usar Integration Hubsem precisar compartilhar credenciais de superusuário. Ele também aumenta a segurança, eliminando a necessidade de gerenciar ACLs para sistemas de terceiros.

    Este recurso requer um Integration Hubassinatura. Para obter mais informações, consulte Cronogramas jurídicos - Visão geral do IntegrationHub.

    Visão geral do painel

    O painel Autenticação pessoal tem duas seções principais.
    • A seção Minhas integrações na parte superior da página, que mostra suas integrações autenticadas.
    • A seção Integrações que posso usar na parte inferior da página, que mostra as integrações disponíveis para você.
    Figura 1. Painel de autenticação pessoal
    O painel Autenticação pessoal com duas seções: A seção Minhas integrações e a seção Integrações que posso usar.
    Seção Minhas integrações

    Exibe integrações autenticadas. Cada integração tem seu próprio cartão. No cartão, você pode Revogar ou Renove a autenticação.

    Ao revogar uma autenticação, você revoga qualquer acesso relevante ou atualiza tokens para a credencial de autenticação pessoal associada à integração. A revogação invalida a autenticação existente. Você pode autenticar novamente mais tarde para restabelecer a conexão. Quando a autenticação é revogada, o cartão de integração é movido para a seção Integrações que posso usar do painel.

    A renovação de uma autenticação renova o token associado e atualiza a data de expiração. Para renovar, selecione Renove no cartão de integrações. Este botão abre uma janela pop-up na qual você pode autenticar novamente a credencial. O conteúdo da janela pop-up depende da integração.
    • Para ServiceNow, a janela pop-up tem campos onde você pode inserir Nome de usuário e. Senha para a credencial, selecione Obter token OAuth .
    • Para todas as outras integrações, a janela pop-up exibe sua página de credencial do OAuth para essa aplicação.
    Seção de integrações que posso usar

    Exibe as integrações que estão disponíveis, mas não autenticadas. Para autenticar, selecione Autenticar no cartão de integração. A autenticação abre a mesma janela pop-up que é aberta quando você Renove Uma integração: Para ServiceNow, a janela pop-up tem Nome de usuário , Senha e. Obter token OAuth botões. Para todas as outras integrações, a janela pop-up exibe sua página de credencial do OAuth para essa aplicação.

    Quando a credencial é autenticada, o cartão de integração é movido para a seção Minhas integrações na parte superior do painel.

    Configuração do painel necessária

    Se você já estiver usando o tipo de credencial de autenticação pessoal, poderá fazer upgrade para o painel instalando o plug-in Autenticação pessoal [com.snc.sn_ihub_personal_auth]. Após instalar o plug-in, navegue até Tudo > IntegrationHub > Autenticação pessoal > Integrações pessoais para ver o painel.

    Todas as integrações no painel vêm da tabela Aliases de conexão e credencial [sys_alias]. Qualquer alias em que a credencial tenha um tipo de integração pessoal é exibido no painel, de acordo com as diretrizes a seguir.
    • No momento, a credencial tiver um token válido, ela será listada na seção Minhas integrações do painel.
    • No momento, a credencial não tiver um token válido, ela será listada na seção Integrações que posso usar do painel.

    Se você ainda não estiver usando o tipo de credencial de autenticação pessoal, poderá configurar um criando um alias de conexão e credencial que usa uma credencial do OAuth 2,0 com o. Tipo de integração de Pessoal . Para obter mais detalhes e instruções, consulte Create a Connection & Credential alias.

    URL de revogação de token

    A revogação de uma autenticação revoga todos os tokens ativos relacionados armazenados na instância do usuário que iniciou a sessão. Você também pode habilitar a revogação de token no Servidor OAuth fornecendo o endpoint de revogação de token do servidor no URL de revogação de token campo.

    Para habilitar a revogação de autenticação no Servidor OAuth, preencha URL de revogação de token Campo no formulário Registros da aplicação para o provedor de OAuth da integração. Para preencher este campo, siga estes passos.
    1. Navegar até Tudo > OAuth de Sistema > Registro de aplicações.
    2. Selecione o formulário para o provedor de OAuth apropriado na tabela Registros de aplicações [oauth_entity].
    3. Em URL de revogação de token Insira o endpoint de revogação de token do servidor OAuth.

    Funções

    O painel Autenticação pessoal requer a função sn_personal_auth.personal_auth_user.