Pular para o conteúdo principal

Autenticação com cURL

Esta página irá ajudá-lo a fazer login e salvar suas credenciais para sua integração Batch do Dataoris, com exemplos de como usar cURL.​

Introdução​

O que é o Comando cURL? É um comando disponível na maioria dos sistemas baseados em Unix. É usado como abreviação de "Client URL". Os comandos cURL são destinados a funcionar como uma forma de verificar a conectividade de uma URL, além de ser uma ótima ferramenta de transferência de dados.

1. Login Você pode executar o comando abaixo para fazer login e obter seu token de acesso.

curl -X 'POST' 'https://grouplink-api.apidatasafe.com/login' -H 'accept: application/json' -H 'Content-Type: application/json' -d '{ "email": "seuemail@email.com", "password": "SuaSenha", "passcode": "001231", "ttl": 86400 }'

O retorno desta chamada será algo similar a {"access_token":"SEU-TOKEN-DE-ACESSO"}

Copie o token retornado para usar na próxima chamada para salvar as credenciais

Documentação em: GroupLinkAPI Login​

2. Salvar credenciais ​Você pode executar o comando abaixo para salvar suas credenciais e obter seu token de acesso.

curl -X 'PATCH' 'https://grouplink-api.apidatasafe.com/organization-vault' -H 'Content-Type: application/json' -H 'Authorization: Bearer SEU-TOKEN-DE-ACESSO' -d '{ "type": "azure_identity", "data": { "tenant_id": "TENANT-123", "client_id": "12345", "client_secret": "G4UL3S", "connection_string": "minhaconnectionstring" }, "namespace": "batch" }'

O retorno será o ID da credencial criada

O namespace usado deve ser informado ao ativar a integração.

Não será possível visualizar os dados completos após serem importados. Os dados são criptografados usando AES 256 GCM na camada de aplicação/banco de dados e novamente todos os dados são salvos com LUKS em repouso no servidor de banco de dados.

Nota: type e data mudam dependendo do armazenamento escolhido (S3, Azure, Google ou direct-link), por favor verifique a documentação em GroupLinkAPI OrganizationVault

Exemplo de criação de bucket e chave de acesso na AWS: Configuração do Bucket AWS S3

3. Listar credenciais ​Você pode executar o comando abaixo para listar suas credenciais e obter seu token de acesso.

curl -X 'GET' 'https://grouplink-api.apidatasafe.com/organization-vault' -H 'Authorization: Bearer SEU-TOKEN-DE-ACESSO'

O retorno será uma lista de credenciais com seus IDs e informações, aproveite para verificar o que você registrou.

Documentação em: GroupLinkAPI OrganizationVaultList ​ 4. Se você quiser deletar uma credencial Execute o comando abaixo substituindo 'ID' pelo ID da credencial se você quiser deletá-la

curl -X 'DELETE' 'https://grouplink-api.apidatasafe.com/organization-vault/ID' --header 'Authorization: Bearer SEU-TOKEN-DE-ACESSO'

O retorno deve ser um HTTP 204

Documentação em: GroupLinkAPI OrganizationVaultDelete