Configurando cada tipo de conta

Saiba mais sobre a configuração de cada um dos tipos de contas utilizadas na Digibee Integration Platform.

Existem diferentes tipos de contas, como AWS V4, Basic, Public Key, Secret Key, OAuth 2 e API Key, e destaca-se que podem ser configuradas e armazenadas com o conector Store Account sem interromper a execução. Abaixo você aprenderá como configurar cada uma dessas contas.

Contas aceitam valores de até 10.000 caracteres.

Tipos de contas

Tipo de conta

Descrição

Campos/Parâmetros

API Key

Armazenamento de API Key para endpoints que precisam de uma API Key.

  • URL-PARAM-NAME: nome do query parameter em que a API Key configurada será utilizada

  • API-KEY: valor da API Key a ser utilizada

Basic

Autenticação de usuário/senha.

  • USERNAME: nome do usuário

  • PASSWORD: senha do usuário

Custom Auth Header

Header de autenticação personalizado para terminais específicos.

  • HEADER-NAME: nome do header

  • HEADER-VALUE: valor do header

OAuth Bearer

Armazenamento para tokens do tipo OAuth, o token será atribuído ao parâmetro "Authorization" no cabeçalho da solicitação.

  • TOKEN: token OAuth

Private Key

Armazenamento para chaves privadas.

  • KEY: Chave privada

  • PASSPHRASE: Senha da chave privada

Public Key

Armazenamento para chaves públicas.

  • KEY: Chave pública

OAuth2

Autorização via padrão OAuth que é comumente usado para permitir que usuários da Internet façam login em outros sites usando suas contas do Google, Microsoft, etc., sem revelar suas senhas. OAuth fornece a eles um "acesso seguro delegado" aos recursos do servidor em nome do proprietário do recurso.

  • PROVIDER: provedor OAuth

  • SCOPES: escopos de acesso OAuth

Certificate Chain

Cadeia de certificados para endpoints que precisam de autenticação 2-way SSL ou certificados de cliente. (A cadeia de certificados deve ser fornecida na ordem correta e no formato pem.)

  • CHAIN: cadeia de certificados completa

  • PASSWORD: senha da chave privada (se necessário)

Secret Key

Usado para conectores de criptografia.

  • KEY: chave secreta

Google Key

Chave de serviço para APIs do Google.

Kerberos

Armazenamento Keytab para autenticações em ambientes que utilizam Kerberos.

  • KEYTAB: base64 do arquivo Keytab

  • PRINCIPAL: usuário dessa Keytab (ex.: user@DOMAIN)

AWS V4

Para acesso ao serviço AWS.

  • SERVICE-NAME: nome do serviço a ser acessado (por exemplo, S3, SQS)

  • ACCESS-KEY: chave criada na AWS para acessar o serviço

  • SECRET-KEY: chave tipo secret key gerada na AWS para acessar o serviço

  • REGION: a região onde o serviço é executado

OAuth Provider

Autorização via padrão OAuth que é geralmente usada para logar em aplicações web. Somente pode ser usada pelo conector Salesforce.

  • CLIENT-ID: o identificador associado com uma aplicação

  • CLIENT-SECRET: o secret associado com uma aplicação

SMTP Auth And Properties

Para Mail Connector, fornece dados de acesso ao servidor SMTP para enviar e-mails.

  • HOST: nome do host do servidor SMTP

  • PORT: porta de acesso ao servidor SMTP

  • USERNAME: email do usuário

  • PASSWORD: senha do email

  • STARTTLS_ENABLE: valores “true” ou “false” - se “true”, o acesso será via SSL.

  • AUTH: tipo de autenticação do servidor de email

NTLM

NTLM (NT Lan Manager) é um conjunto de protocolos de segurança Microsoft para autenticação, integridade e confidencialidade que pode ser acessado por meio do conector SOAP V3.

  • USERNAME: nome do usuário

  • PASSWORD: senha utilizada para o acesso

  • DOMAIN (opcional): nome do domínio

  • HOSTNAME (opcional): nome do host

Informações e exemplos

Temos algumas informações importantes sobre algumas Contas e alguns exemplos, veja abaixo:

Informações

OAuth 2

Importante: Suportamos os seguintes provedores:

  • Microsoft: é obrigatório o escopo "offline_access" para utilização na Digibee Integration Platform. Também é importante lembrar que esse provedor aceita apenas contas pessoais;

  • Google;

  • Mercado Livre.

API Key

Importante: Os provedores a seguir definem um período de expiração para seus tokens de autenticação. Por este motivo, é necessário atualizar as configurações das suas Contas ao final de cada período.

  • Microsoft: a cada 3 meses

  • Google: a cada 6 meses

  • Mercado Livre: a cada 6 meses

Certificate Chain

Para converter sua chave, você pode fazê-lo através do OpenSSL através da linha de comando, por exemplo: openssl pkcs12 -in mycert_xpto.p12 -out myapp.pem

Exemplos

Private Key

-----BEGIN RSA PRIVATE KEY-----
MIICWwIBAAKBgF2duc4+xxNKlMO9bUud4bzGnuATkQVX3bM/gzxISrgw7B1AzJwA
OT5UChBoIKfmISaaVVY9+/fTpI1szihSqTyemdHnbC+FcDzoK3p53C5ZJ4pL7s+G
Y7vGEa2Z/6JVder6dwJaaOtwf+DfZYiWQjvh8tfAVjVdONE/XZSxOOofAgMBAAEC
-----END RSA PRIVATE KEY-----

Public Key

-----BEGIN PUBLIC KEY-----
MIGeMA0GCSqGSIb3DQEBAQUAA4GMADCBiAKBgF2duc4+xxNKlMO9bUud4bzGnuAT
kQVX3bM/gzxISrgw7B1AzJwAOT5UChBoIKfmISaaVVY9+/fTpI1szihSqTyemdHn
-----END PUBLIC KEY-----

Certificate Chain

-----BEGIN CERTIFICATE-----
MIIEUTCCAzmgAwIBAgIBATANBgkqhkiG9w0BAQUFADBSMQswCQYDVQQGEwJVUzEj
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
MIIEUTCCAAGVDSHVEbjhdbhjsjeiejAQUFADBSMQswCQYDVQQGEwJVUzEj
-----END CERTIFICATE-----
-----BEGIN RSA PRIVATE KEY-----
MIICWwIBAAKBgF2duc4+xxNKlMO9bUud4bzGnuATkQVX3bM/gzxISrgw7B1AzJwA
-----END RSA PRIVATE KEY-----

Google Key

{
"type": "service_account",
"project_id": "project_id",
"private_key_id": "dfdsfrfr43r43r4refbcceceabf8055a12a",
"private_key": "-----BEGIN PRIVATE KEY-----\n-----END PRIVATE KEY-----\n",
"client_email": "user@DOMAIN.iam.gserviceaccount.com",
"client_id": "123456576788888899",
"auth_uri": "https://accounts.google.com/o/oauth2/auth",
"token_uri": "https://accounts.google.com/o/oauth2/token",
"auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
"client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/storage%40project.iam.gserviceaccount.com"
}

Last updated