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 cURL.
Introdução
O que é o Comando cURL? É um comando disponível na maioria dos sistemas baseados em Unix. Ele é usado como uma abreviação para “Client URL”. Comandos cURL são destinados a funcionar como uma maneira 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": "youremail@email.com", "password": "YourPassword", "passcode": "001231", "ttl": 86400 }'
O retorno desta chamada será algo semelhante a {"access_token":"YOUR-ACCESS-TOKEN"}
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 YOUR-ACCESS-TOKEN' -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: 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 YOUR-ACCESS-TOKEN'
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 YOUR-ACCESS-TOKEN'
O retorno deve ser um HTTP 204
Documentação em: GroupLinkAPI OrganizationVaultDelete