Pular para o conteúdo principal

Login e credenciais utilizando cURL

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

Introdução​

O que é o comando cURL? É um comando disponível na maioria dos sistemas baseados em Unix. É usado como uma abreviação para “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 será algo como {"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": "minhastringdeconexao" }, "namespace": "batch" }'

O retorno será o ID da credencial criada. O namespace utilizado 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: tipo e dados 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 um bucket e chave de acesso na AWS: Bucket na AWS para recebimento dos arquivos

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