mirror of
https://github.com/qdrant/landing_page.git
synced 2026-09-30 08:28:32 +02:00
114 lines
3.2 KiB
Markdown
114 lines
3.2 KiB
Markdown
---
|
|
title: Authentication
|
|
weight: 30
|
|
---
|
|
|
|
# Database Authentication in Qdrant Managed Cloud
|
|
|
|
This page shows you how to use the Qdrant Cloud Console to create a Database API key for a cluster. You will learn how to connect to your cluster using the new API key.
|
|
|
|
## Create Database API keys
|
|
|
|
The API key is only shown once after creation. If you lose it, you will need to create a new one.
|
|
However, we recommend rotating the keys from time to time. To create additional API keys do the following.
|
|
|
|
1. Go to the [Cloud Dashboard](https://qdrant.to/cloud).
|
|
2. Go to the **API Keys** section of the Cluster detail page.
|
|
3. Click **Create**. If you have granular access control activated, you can now configure the permissions for the new key.
|
|
4. Click **OK** and retrieve your API key.
|
|
|
|
## Test cluster access
|
|
|
|
After creation, you will receive a code snippet to access your cluster. Your generated request should look very similar to this one:
|
|
|
|
```bash
|
|
curl \
|
|
-X GET 'https://xyz-example.eu-central.aws.cloud.qdrant.io:6333' \
|
|
--header 'api-key: <paste-your-api-key-here>'
|
|
```
|
|
Open Terminal and run the request. You should get a response that looks like this:
|
|
|
|
```bash
|
|
{"title":"qdrant - vector search engine","version":"1.8.1"}
|
|
```
|
|
|
|
> **Note:** You need to include the API key in the request header for every
|
|
> request over REST or gRPC.
|
|
|
|
## Authenticate via SDK
|
|
|
|
Now that you have created your first cluster and key, you might want to access your database from within your application.
|
|
Our [official Qdrant clients](/documentation/interfaces/) for Python, TypeScript, Go, Rust, .NET and Java all support the API key parameter.
|
|
|
|
```bash
|
|
curl \
|
|
-X GET https://xyz-example.eu-central.aws.cloud.qdrant.io:6333 \
|
|
--header 'api-key: <provide-your-own-key>'
|
|
|
|
# Alternatively, you can use the `Authorization` header with the `Bearer` prefix
|
|
curl \
|
|
-X GET https://xyz-example.eu-central.aws.cloud.qdrant.io:6333 \
|
|
--header 'Authorization: Bearer <provide-your-own-key>'
|
|
```
|
|
|
|
```python
|
|
from qdrant_client import QdrantClient
|
|
|
|
qdrant_client = QdrantClient(
|
|
"xyz-example.eu-central.aws.cloud.qdrant.io",
|
|
api_key="<paste-your-api-key-here>",
|
|
)
|
|
```
|
|
|
|
```typescript
|
|
import { QdrantClient } from "@qdrant/js-client-rest";
|
|
|
|
const client = new QdrantClient({
|
|
host: "xyz-example.eu-central.aws.cloud.qdrant.io",
|
|
apiKey: "<paste-your-api-key-here>",
|
|
});
|
|
```
|
|
|
|
```rust
|
|
use qdrant_client::Qdrant;
|
|
|
|
let client = Qdrant::from_url("https://xyz-example.eu-central.aws.cloud.qdrant.io:6334")
|
|
.api_key("<paste-your-api-key-here>")
|
|
.build()?;
|
|
```
|
|
|
|
```java
|
|
import io.qdrant.client.QdrantClient;
|
|
import io.qdrant.client.QdrantGrpcClient;
|
|
|
|
QdrantClient client =
|
|
new QdrantClient(
|
|
QdrantGrpcClient.newBuilder(
|
|
"xyz-example.eu-central.aws.cloud.qdrant.io",
|
|
6334,
|
|
true)
|
|
.withApiKey("<paste-your-api-key-here>")
|
|
.build());
|
|
```
|
|
|
|
```csharp
|
|
using Qdrant.Client;
|
|
|
|
var client = new QdrantClient(
|
|
host: "xyz-example.eu-central.aws.cloud.qdrant.io",
|
|
https: true,
|
|
apiKey: "<paste-your-api-key-here>"
|
|
);
|
|
```
|
|
|
|
```go
|
|
import "github.com/qdrant/go-client/qdrant"
|
|
|
|
client, err := qdrant.NewClient(&qdrant.Config{
|
|
Host: "xyz-example.eu-central.aws.cloud.qdrant.io",
|
|
Port: 6334,
|
|
APIKey: "<paste-your-api-key-here>",
|
|
UseTLS: true,
|
|
})
|
|
```
|