Authentification

L’authentification passe par un système de clés d’API à transmettre via Basic Auth

Créer une clé d’API pour votre organisation

Pour créer une clé d’API, qui effectuera les requêtes au nom de votre organisation, suivez ces étapes

1. Se connecter sur https://app.biron-analytics.com
2. Naviguer vers Administration > Clés d’API
3. Cliquer sur Créer une clé d’API.
4. Rentrez les détails et choisissez le minimum de permission nécessaire.
5. Copiez le nom d’utilisateur et mot de passe.

Gardez le mot de passe secret

Attention à ne jamais rendre disponible le mot de passe de la clef d’API visible

Alternative: se créer un jeton d’accès personnel

Pour des besoins ponctuels d’exploration ou d’opérations uniques, vous pouvez utiliser des jetons d’accès personnel qui vous identifient vous-même sur la plateforme.

Le fonctionnement est exactement le même que pour une clef d’API d’organisation, mais vous devez vous rendre sur Votre profil > Jetons d’accès personnels

Utilisez la date d'expiration

Pour renforcer la sécurité, il est fortement recommandé d’entrer une date d’expiration.

Utiliser la clef d’API

Pour des requêtes API

Il faut l’inclure dans le header Authorization de la requête HTTP, en encodant username:password en Base64, donnant par exemple Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=

curl -u "username:password" \
     -X POST "https://nexus.biron-analytics.com/workspace/birondemo_prod/query/sql/http-sample"

Pour des requêtes Clickhouse

Lors de connexion directe au datawarehouse, il faut transmettre le nom d’utilisateur et le mot de passe tels que transmis lors de la création de la clef d’API.