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 de token de acesso pessoal, usamos o tipo de autenticação Token de Acesso Pessoal (PAT). O exemplo da API Generate Image 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 OAuth 2.0.

Algumas APIs, como os recursos ODataV2 do SAP S4, usam um cabeçalho personalizado como a 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 por chave de API.

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