Login e Credenciais Usando cURL
Esta página irá ajudá-lo a fazer login e salvar suas credenciais para sua nova integração, 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 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 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
Docs em: GroupLinkAPI Login
2. Salvar credenciais Você pode executar o comando abaixo para salvar suas credenciais e obter seu access-token.
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": "myconnectionstring" }, "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). Para exemplos completos com todos os tipos de armazenamento suportados, veja Body Types & Examples. Você também pode verificar a documentação em GroupLinkAPI OrganizationVault
Exemplo de criação de bucket e chave de acesso na AWS: Bucket na AWS para recebimento de arquivos
3. Listar credenciais Você pode executar o comando abaixo para listar suas credenciais e obter seu access-token.
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.
Docs 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
Docs em: GroupLinkAPI OrganizationVaultDelete
Próximos Passos
Após fazer login e entender o processo de autenticação, confira os exemplos completos de body types:
Body Types & Examples - Exemplos completos para todos os tipos de armazenamento suportados (AWS S3, Azure, Google Cloud, API Token) com exemplos cURL e Swagger.