Ir para o conteúdo

Provedores de segurança no Jitterbit App Builder

Introdução

Um provedor de segurança é um módulo configurável que verifica a identidade no App Builder. Dependendo do seu tipo, um provedor de segurança pode autenticar os usuários que fazem login em seus aplicativos, as conexões que o App Builder estabelece com fontes de dados externas e servidores de e-mail, ou requisições para serviços de relatórios. O App Builder inclui tipos de provedor para métodos de autenticação comuns, como contas de usuário locais, SAML, OAuth, OpenID Connect e chaves de API, para que você possa usar os métodos que sua organização já adota.

Esta página descreve a página Security, onde você adiciona e gerencia provedores de segurança. Ela aborda o painel Security Providers que lista seus provedores, a página Provider onde você configura cada um, e o painel Configuration que contém configurações aplicáveis a todos os provedores de segurança.

Acessar provedores de segurança

Para abrir a página Security, siga estas etapas:

  1. Abra o IDE.

  2. No painel Connect, clique em Security Providers.

  3. A página Security será aberta:

    Security page

A página Security possui dois painéis:

  • Security Providers: Lista todos os provedores de segurança configurados à direita. Veja Painel Security Providers.

  • Configuration: Contém configurações que se aplicam a todos os provedores de segurança à esquerda. Veja Painel Configuration.

Painel Security Providers

O painel Security Providers lista todos os provedores de segurança configurados no App Builder. A lista inclui ferramentas de filtro e busca. Para adicionar um provedor de segurança, veja Adicionar um novo provedor de segurança. Para maximizar o painel para a largura total da página, clique no ícone maximizar no canto superior direito. Clique no ícone restaurar para restaurar o painel Configuration.

Cada linha na lista mostra o seguinte:

  • Name: O nome que identifica o provedor de segurança.

  • Scheme: Um nome exclusivo e seguro para URL que identifica o provedor de segurança. Veja Configurações.

  • Type: O tipo de classificação do provedor de segurança, como SAML Identity Provider, HTTP ou OAuth. Veja Tipos de provedor.

  • Authentication: Ícones que mostram os tipos de autenticação que o provedor de segurança suporta. Veja Ícones da coluna Authentication.

  • Enabled: Uma caixa de seleção que mostra uma marca de seleção verde quando o provedor de segurança está ativado no ambiente App Builder.

Para abrir a página Provider de um provedor de segurança, clique no ícone de chevron ao final de sua linha. Veja Editar um provedor de segurança.

Ícones da coluna Authentication

A coluna Authentication mostra um ícone para cada tipo de autenticação que um provedor de segurança suporta. Passe o mouse sobre o cabeçalho da coluna Authentication para ver uma legenda dos ícones.

Ícone Tipo de autenticação Descrição
Autenticação de usuário Autentica os usuários que fazem login em aplicativos App Builder.
Autenticação de fonte de dados Autentica as conexões do App Builder com fontes de dados externas.
Autenticação de servidor de e-mail Autentica as conexões do App Builder com servidores de e-mail.
Autenticação de relatório Autentica requisições para um serviço de relatórios, como Adobe PDF Services.

Um único provedor de segurança pode ter mais de um ícone. Por exemplo, um provedor de segurança Salesforce / OpenID Connect pode autenticar tanto usuários quanto fontes de dados.

Menu do painel Security Providers

Clique em More no topo do painel Security Providers para abrir um menu com as seguintes opções:

  • Login Form: Configura quais provedores de autenticação aparecem no formulário de login.

  • Aplicações: Configura as definições de autenticação da aplicação, incluindo o provedor de autenticação padrão e página de login, e quais provedores de autenticação podem autenticar solicitações de serviço web.

  • Conector Remoto: Configura quais provedores podem autenticar solicitações de conector remoto.

  • Serviços de Relatório: Configura os provedores de segurança responsáveis por autenticar solicitações de serviço de relatório.

  • Pipeline de Solicitações: Configura e sequencia os provedores de segurança que interagem com solicitações HTTP.

  • Importar Provedor: Cria um provedor de segurança fazendo upload de um arquivo de configuração JSON.

Adicionar um novo provedor de segurança

Para adicionar um provedor de segurança, clique no botão + Provedor de Segurança acima da lista no painel Provedores de Segurança. A página Provedor é aberta, com seus campos organizados nas seções descritas nos títulos a seguir:

Página Provedor

Os campos que aparecem variam conforme o Tipo selecionado. Por exemplo, OAuth adiciona as seções Autenticação e Tokens, e JWT SSO adiciona uma seção Tokens com campos diferentes. Consulte a documentação do seu tipo de provedor para suas configurações adicionais. Depois de preencher os campos, clique em Salvar. Os painéis de que o tipo de provedor precisa aparecerão no lado direito da página. Consulte Painéis da página Provedor.

Configurações

  • Nome: Digite um nome para identificar o provedor de segurança. O nome aparece em todo o IDE. No caso de provedores de autenticação de usuário, o nome também aparece no formulário de login. É possível renomear um provedor de segurança a qualquer momento sem afetar URLs construídas a partir do seu Esquema.

  • Tipo: Use a lista suspensa para selecionar o tipo de provedor de segurança. Os tipos normalmente correspondem a um protocolo, a um padrão de autenticação ou a um esquema específico do fornecedor. O tipo não pode ser alterado posteriormente. Consulte Tipos de provedor.

  • Prioridade: Um número inteiro que define a ordem em que os provedores de segurança aparecem no formulário de login e são executados no pipeline de solicitações.

  • Habilitado: Marque para habilitar o provedor de segurança. Um provedor de segurança desabilitado não aparece no formulário de login e não pode ser usado para autenticar usuários.

  • Esquema: (App Builder 4.67 e posterior) Um identificador único e amigável para URLs do provedor de segurança. O esquema aparece em URLs e documentos JSON, portanto use apenas letras ASCII, números, pontos, sublinhados e hífens, e prefira caracteres em minúsculas. Ele é usado para criar URLs de retorno de chamada e outros identificadores voltados para máquinas (por exemplo, https://example.com/Vinyl/signin-Scheme). Para provedores de segurança criados antes do App Builder 4.67, o esquema assume como padrão o nome do provedor como está. Para provedores de segurança criados no App Builder 4.67 ou posterior, o App Builder gera um esquema amigável para URLs a partir do nome. Os administradores podem editar o esquema, embora isso possa quebrar links de provedores de Logon Único (SSO) de terceiros.

  • Identificador: Um identificador único para o provedor de segurança. Este campo é gerado automaticamente.

Entrar

  • Redirecionar ao Desafio: Marque para ignorar o formulário de login e redirecionar o usuário para o Provedor de Identidade (IdP).

  • Mostrar no Formulário de Login: Marque para mostrar este provedor de segurança no formulário de login.

  • Página Padrão: A página para a qual o usuário é redirecionado após autenticar. A página deve ser marcada como pública.

  • Página de Saída: A página para a qual o usuário é redirecionado após sair. A página deve ser marcada como pública.

Provisionamento

  • Provisionamento de Usuário: Marque para que o App Builder crie contas de usuário com base na identidade fornecida pelo IdP. Os atributos do usuário são mapeados usando claims. Consulte Provisionamento de usuário e grupo.

  • Corresponder Usuário Existente: Marque para que o App Builder mapeie contas de usuário existentes com base na identidade fornecida pelo IdP. Use esta opção apenas com um IdP totalmente confiável, pois um IdP não confiável poderia usá-la para acessar qualquer conta. Por exemplo, se o IdP tiver um usuário chamado Admin, esse usuário teria acesso ao administrador local padrão fornecido com o App Builder. Um diretório de funcionários da empresa é um exemplo de um IdP totalmente confiável. Um provedor de SSO social como Google ou Facebook não é totalmente confiável.

  • Associação ao Grupo de Fornecedores: Marque para indicar que o IdP inclui declarações de associação de grupo no token de segurança. O App Builder registra as declarações como grupos do provedor, que você pode mapear para grupos de usuários. Consulte Grupos de provedores.

  • Formato de Nome: Uma cadeia de caracteres de formato de nome personalizado. Suporta substituição dinâmica, por exemplo Example\Example JWT SSO.

  • Formato do Identificador de Nome: Uma cadeia de caracteres de formato de identificador de nome personalizado. Suporta substituição dinâmica, por exemplo Example\Example JWT SSO.

  • URL do Provedor de Identidade: O endereço do IdP que permite aos administradores gerenciar usuários.

Painéis da página do Provedor

Depois de salvar um provedor de segurança, o lado direito da página Provedor mostra painéis onde você adiciona os detalhes que o tipo de provedor precisa. Os painéis exibidos variam de acordo com o tipo de provedor e podem incluir Pontos de extremidade, Credenciais, Certificados, Propriedades e Declarações. Clique no botão + na parte superior de um painel para adicionar uma linha. Consulte a documentação do seu tipo de provedor para os valores a inserir. O exemplo a seguir mostra a página Provedor para um provedor de segurança OAuth:

Página do Provedor para um provedor de segurança OAuth

Os painéis possuem as seguintes colunas:

  • Pontos de extremidade:

    • Tipo: Indica como o ponto de extremidade é usado.

    • URL: O endereço do ponto de extremidade. Deve ser uma URL absoluta.

  • Credenciais:

    • Tipo: Descreve como a credencial é usada no esquema de autenticação.

    • Nome de Usuário: O nome de usuário ou identificador da credencial.

  • Certificados:

    • Uso: Indica se o certificado é usado para assinar tokens, validar assinaturas de tokens ou criptografar cargas de mensagens.
  • Propriedades:

    • Parâmetro: Identifica uma propriedade nomeada e configurável. Cada provedor de segurança suporta parâmetros diferentes.

    • Valor: Fornece o valor para o parâmetro nomeado. Os valores permitidos variam de acordo com o parâmetro.

  • Declarações:

    • Uso: Indica como as declarações desse tipo são mapeadas para atributos internos da conta de usuário.

    • Prioridade: Se o token de segurança contiver duas declarações com o mesmo uso, usa-se a declaração com prioridade mais alta (valor mais baixo).

    • Identificador: O identificador da declaração, normalmente uma URI ou outra cadeia de caracteres bem conhecida, como uma chave JSON.

O painel Declarações também possui os seguintes botões:

  • Descobrir: Abre a caixa de diálogo Tipos de Declarações do Provedor. Selecione Armazenar Declarações para fazer com que o App Builder registre todas as declarações extraídas do token de segurança durante o processo de autenticação, o que pode ser útil para solução de problemas. As declarações registradas aparecem em Declarações Armazenadas. Para removê-las, clique em Mais e selecione Excluir Declarações Armazenadas.

  • Declarações Padrão: Abre a caixa de diálogo Tipos de Declarações Padrão, que lista os tipos de declarações padrão. As colunas Identificador, Uso e Prioridade são as mesmas da lista anterior. As outras colunas são as seguintes:

    • Fonte: Indica onde o tipo de declaração padrão está definido.

    • Nome: Um nome amigável para a declaração.

    • Ignorar: Indica que a declaração deve ser ignorada. Use isso para substituir os tipos de declarações padrão ou para excluir declarações que mudam sempre que o usuário faz login, como um timestamp.

Tipos de provedores

A lista suspensa Tipo agrupa os tipos de provedores de segurança da seguinte forma. Selecione o nome de um tipo para saber mais sobre ele.

Editar um provedor de segurança

Para editar um provedor de segurança, siga estas etapas:

  1. No painel Provedores de Segurança, clique no ícone de seta no final da linha do provedor de segurança. A página Provedor é aberta.

  2. Clique em Editar. Os botões Salvar, Cancelar e Validar substituem Editar, e os campos ficam editáveis. O Tipo não pode ser alterado.

  3. Atualize os campos e clique em Salvar. Para descartar as alterações, clique em Cancelar.

Para verificar a configuração de um provedor de segurança, clique em Validar no topo da página Provedor. Se o App Builder detectar problemas, ele os lista no topo da página, por exemplo, um endpoint obrigatório ou um identificador de cliente ausente.

Menu da página do Provider

Clique em Mais no canto superior direito da página Provider para abrir um menu com as seguintes opções:

  • Invalidar Tokens: Revoga tokens de acesso emitidos pelo provedor de segurança.

  • Exportar Provider: Exibe a configuração do provedor de segurança serializada.

  • Gerenciar Grupos: Abre a caixa de diálogo Grupos do Provider, onde você cria os grupos do provedor de segurança e os mapeia para grupos de segurança do App Builder. Consulte Grupos do Provider.

  • Changelog: Lista as alterações feitas no provedor de segurança.

  • Deletar Provider: Deleta o provedor de segurança.

Painel de configuração

O painel Configuração fica no lado esquerdo da página Segurança. Ele contém configurações que se aplicam a todos os provedores de segurança. Para alterar as configurações, clique em Editar no topo do painel. Os botões Salvar e Cancelar substituem Editar, e as configurações ficam editáveis, exceto Usuário Anônimo. Atualize as configurações e clique em Salvar. Para descartar suas alterações, clique em Cancelar.

Configurações de autenticação

  • Usuário Anônimo: O grupo especificado para lidar com autenticação anônima no ambiente App Builder, por exemplo, Anonymous Users.

  • Expiração de Autenticação: O tempo de vida do token de segurança, medido em minutos.

  • Autenticação Padrão: Especifica o provedor de autenticação a usar por padrão no ambiente App Builder.

  • Tema da Página de Login: Substitui o tema padrão da página de login. Todos os temas da página de login devem estender o Tema Base de Login. Consulte Como personalizar a página de login para detalhes.

  • Página de Login: Substitui a página de login padrão por uma página de login personalizada. O usuário anônimo deve ter acesso à página de login personalizada.

  • URL de Convite: Um link para uma página que permite aos usuários enviar um convite para criar uma conta.

Configurações de sessão

  • Armazenamento de Sessão: Determina quando as sessões são armazenadas.

  • Expiração Anônima: Determina por quanto tempo as sessões anônimas são armazenadas.

  • Máximo Concorrente: Limita o número máximo de sessões simultâneas por conta de usuário.

Menu do painel de configuração

Clique em Mais no topo do painel Configuração para abrir um menu com as seguintes opções:

  • Sites: Gerencia URLs de sites e redirecionamentos.

  • URLs Permitidas: Gerencia a lista de URLs aprovadas.

  • Inspecionar Requisição: Exibe informações da sessão de navegador atual, incluindo o esquema de URL, host e porta, além dos cabeçalhos HTTP.

  • Invalidar Tokens: Invalida todos os tokens de autenticação de sessão.

Diferenças no App Builder 4.68 e anteriores

No App Builder 4.68 e anteriores, a página Segurança possui painéis separados de Autenticação de Usuário, Autenticação de Fonte de Dados e Autenticação de Servidor de Email, cada um com seu próprio botão + para adicionar um provedor. No App Builder 4.69 e posteriores, esses painéis são combinados no painel Provedores de Segurança, onde cada provedor aparece uma única vez.

Para seguir instruções na documentação que se referem a + Security Provider, clique no botão + Autenticação de Usuário, + Autenticação de Fonte de Dados ou + Autenticação de Servidor de Email que corresponde ao provedor que você está criando e, em seguida, selecione seu Tipo.

Algumas opções do menu Mais também foram renomeadas ou movidas na versão 4.69:

  • Gerenciar Aplicações agora é Aplicações.

  • Gerenciar Sites agora é Sites.

  • Importar Provider e Pipeline de Requisição agora estão no menu Mais do painel Provedores de Segurança em vez de estarem no painel Configuração.