Lindorm:Gestion des utilisateurs et des autorisations

ALTER SYSTEM SET USER_AUTH=TRUE;

SHOW PARAMETER USER_AUTH;

lindorm-cli

lindorm-cli -url <Endpoint for LindormTSDB SQL> -username <Username> -password <Password> -database <Database name>

Pour plus d'informations, consultez la section Utiliser Lindorm-cli pour se connecter à LindormTSDB et l'utiliser.

JDBC

String url = "<Endpoint for LindormTSDB SQL>";
String username = "<Username>";
String password = "<Password>";
Connection conn = null;

try {
    conn = DriverManager.getConnection(url, username, password);
    // Perform operations after the client is connected to LindormTSDB.
} catch (SQLException e) {
    e.printStackTrace();
}

Pour plus d'informations, consultez le tutoriel Utiliser le pilote JDBC pour Lindorm afin de se connecter à LindormTSDB et l'utiliser.

Pool de connexions Druid

dataSource.setDriver(DriverManager.getDriver("<Endpoint for LindormTSDB SQL>"))
dataSource.setUrl("<Endpoint for LindormTSDB SQL>")
dataSource.setUsername("<Username>")
dataSource.setPassword("<Password>")

Pour plus d'informations, consultez le tutoriel Utiliser le pool de connexions Druid pour se connecter à LindormTSDB.

API HTTP

Les applications qui utilisent des opérations d'API HTTP compatibles avec OpenTSDB doivent inclure les identifiants dans l'en-tête Authorization sous forme de chaîne encodée en Base64.

L'exemple suivant construit l'en-tête d'autorisation et envoie une requête SQL :

import base64
import requests

url      = "<HTTP Endpoint for LindormTSDB>/api/v2/sql"
username = "<Username>"
password = "<Password>"

# Encode credentials as Base64
credentials = base64.b64encode(f"{username}:{password}".encode()).decode()

headers = {
    "Content-Type": "text/plain",
    "Authorization": f"Basic {credentials}"
}

response = requests.post(url, headers=headers, data="SELECT * FROM my_table LIMIT 10")
print(response.json())

Pour les applications utilisant les SDK TSDB, transmettez les identifiants via la méthode basicAuth lors de la création d'un objet TSDBConfig.

Pour la spécification complète de l'authentification, consultez la section Spécifier les identifiants utilisateur pour l'authentification. Pour plus de détails sur le format de la requête, consultez la section Contenu de la requête.

Types d'autorisations

LindormTSDB définit quatre types d'autorisations :

Les autorisations effectives d'un utilisateur correspondent à l'union de toutes les autorisations accordées. Par exemple, un utilisateur disposant des autorisations GLOBAL READ et DATABASE READ sur DB1 peut interroger les données de toutes les bases de données.

Étendues des autorisations

Les autorisations sont accordées selon l'une des deux étendues suivantes :

• GLOBAL — S'applique à toutes les bases de données et tables de l'instance. Un utilisateur disposant de l'autorisation GLOBAL READ peut interroger n'importe quelle table de séries temporelles dans n'importe quelle base de données.

• DATABASE — S'applique à toutes les tables d'une base de données spécifique. Un utilisateur disposant de l'autorisation READ sur DB1 peut interroger n'importe quelle table de séries temporelles dans DB1.

Règles d'autorisation

• L'étendue de l'autorisation SYSTEM est toujours GLOBAL. Elle ne peut pas être limitée à une seule base de données.

• Seuls les utilisateurs disposant des autorisations GLOBAL ADMIN ou SYSTEM peuvent créer, supprimer ou modifier des utilisateurs, ou leur accorder des autorisations.

Utiliser SQL

Utilisez les instructions SQL suivantes pour gérer les utilisateurs et les autorisations :

Utiliser le système de gestion de cluster

Les données relatives aux utilisateurs et aux autorisations sont partagées entre LindormTSDB et LindormTable. Si LindormTable est activé, connectez-vous au système de gestion de cluster LindormTable pour gérer les utilisateurs et les autorisations. Pour plus d'informations, consultez la section Se connecter au système de gestion de cluster.

Autorisations requises pour les instructions SQL

Le tableau suivant répertorie les autorisations requises pour exécuter des instructions SQL courantes. Pour identifier les autorisations nécessaires à une instruction spécifique, repérez la ligne correspondante et vérifiez les colonnes marquées d'un ○.

○ = requis, × = non requis.

Autorisations requises pour les opérations d'API HTTP compatibles avec OpenTSDB

Toutes les opérations d'API HTTP compatibles avec OpenTSDB nécessitent des autorisations à l'étendue GLOBAL. ○ = requis, × = non requis.