Introdução

Você pode criar um conector personalizado a partir de uma tela em branco ou de uma especificação de API.

Antes de criar um conector, primeiro se familiarize com os tipos de autenticação disponíveis.

Tipos de autenticação

Esta seção explica os tipos de autenticação mais comuns disponíveis no Connector Builder. Inclui uma comparação entre três tipos de autenticação em termos de caso de uso, fluxo de autenticação e segurança. Para obter mais detalhes, consulte Tipos de autenticação.

Fluxo de código de autorização do OAuth 2.0

• Ideal para aplicativos que precisam acessar dados de usuários em nome do usuários.
• Alta segurança: o token de acesso nunca está exposto ao agente do usuário e é trocado de servidor para servidor.

Fluxo:

1. Autorização do usuário: o usuário é redirecionado para o servidor de autorização para conceder acesso.
2. Código de autorização: se o usuário conceder o acesso, um código de autorização é retornado ao cliente.
3. Troca de tokens: o cliente troca o código de autorização por um token de acesso no endpoint do token.

Fluxo de código de credenciais do cliente OAuth 2.0

• Adequado para interações de servidor para servidor em que nenhuma interação do usuário está envolvida.
• Segurança moderado: depende de que as credenciais do cliente sejam mantidas em segurança.

Fluxo:

1. Solicitação direta de token: o cliente solicita diretamente um token de acesso do servidor de autorização usando suas credenciais de cliente.
2. Token de acesso: o servidor de autorização retorna um token de acesso

Chave de API

• Simples e rápido de implementar, frequentemente usado para APIs públicas.
• Baixa segurança: as chaves de API podem ser facilmente compartilhadas ou expostas.

Fluxo:

Uso da Chave de API: o usuário inclui uma chave de API em cada solicitação para autenticar.

Escolhendo um fluxo de autenticação

No Exemplo A: construir um conector a partir de uma tela em branco com autenticação do Token de acesso pessoal, usamos o tipo de autenticação do Token de acesso pessoal (PAT). O exemplo de API Gerar imagem segue a prática padrão de usar o cabeçalho de autorização com o esquema de Portador para a chave de API, especialmente para tokens do OAuth 2.0.

Algumas APIs, como recursos SAP S4 ODataV2, usam um cabeçalho personalizado como Chave de API para autenticar o aplicativo. Isso é usado no Exemplo B: criar um conector a partir de uma tela em branco com autenticação de chave de API.

Exemplo C: crie um conector a partir de uma especificação de API com o fluxo de credenciais de cliente do OAuth 2.0 usa o fluxo de credenciais do cliente do OAuth 2.0 com um aplicativo OAuth 2.0.