Aller au contenu principal

Obtenir le jeton SDK

Pour utiliser le SDK Azeoo, vous devez obtenir une clé API (jeton SDK) depuis le panneau d’administration de la plateforme Azeoo Client.

Aperçu​

Le jeton du SDK est un identifiant unique qui authentifie votre application auprès des services Azeoo. Ce jeton est nécessaire pour initialiser le SDK et accéder à toutes les fonctionnalités.

Étapes pour obtenir votre jeton SDK​

1. Inscrivez-vous à la plateforme Azeoo​

  1. Visitez la page Azeoo Client Platform (ou le portail d’administration Azeoo de votre organisation)
  2. Cliquez sur "S’inscrire" ou "Créer un compte" si vous n’avez pas de compte
  3. Renseignez les informations de votre organisation :
    • Nom de l’entreprise / de l’organisation
    • Adresse e-mail
    • Informations de contact
    • Informations professionnelles

2. Finaliser le paiement​

  1. Après l’inscription, allez dans la section "Facturation" ou "Abonnement"
  2. Choisissez un plan d’abonnement qui inclut l’accès au SDK :
    • Starter Plan : fonctionnalités de base du SDK
    • Professional Plan : accès complet au SDK avec des fonctionnalités avancées
    • Enterprise Plan : fonctionnalités sur mesure et support dédié
  3. Finalisez le paiement en utilisant la méthode de votre choix
  4. Attendez la confirmation du paiement (généralement instantanée)

3. Accéder au panneau d’administration​

  1. Une fois le paiement confirmé, connectez-vous à votre compte
  2. Allez dans la section "SDK" ou "Développeur" du panneau d’administration
  3. Vous verrez le tableau de bord de votre organisation

4. Générer le jeton SDK​

  1. Dans la section SDK, cliquez sur "Créer un nouveau jeton SDK" ou "Générer une clé API"
  2. Renseignez les détails du jeton :
    • Application Name : nom de votre application Android
    • Platform : sélectionnez "Android"
    • Environment : choisissez "Production" ou "Développement"
    • Description : description optionnelle pour votre référence
  3. Cliquez sur "Générer le jeton"
  4. Votre jeton SDK s’affichera (par ex. azeoo_android_xxxxxxxxxxxxxxxxxxxxx)

5. Enregistrer votre jeton en toute sécurité​

⚠️ Important : copiez et enregistrez votre jeton SDK immédiatement. Pour des raisons de sécurité, il ne sera affiché qu’une seule fois.

  • Enregistrez-le dans un emplacement sécurisé
  • Utilisez local.properties ou gradle.properties pour le développement local
  • Ne committez jamais les jetons dans le contrôle de version
  • Envisagez d’utiliser un service de gestion des secrets en production

Format du jeton​

Les jetons du SDK suivent ce format :

azeoo_android_<environment>_<unique_identifier>

Exemple :

azeoo_android_prod_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

Bonnes pratiques de sécurité pour le jeton​

  1. Ne jamais exposer les jetons dans le code côté client - utilisez un proxy côté serveur lorsque possible
  2. Stocker dans un stockage sécurisé - utilisez Android Keystore ou des préférences sécurisées
  3. Pivoter les jetons régulièrement - générez de nouveaux jetons et révoquez les anciens
  4. Utiliser des jetons différents pour le développement et la production
  5. Surveiller l’utilisation des jetons - vérifiez le panneau d’administration en cas d’activité inhabituelle
  6. Révoquer immédiatement les jetons compromis

Stocker les jetons sur Android​

Option 1 : local.properties (recommandée pour le développement)​

Créez ou modifiez local.properties à la racine de votre projet :

azeoo.api.key=your-api-key-here

Ajoutez à .gitignore :

local.properties

Récupérez dans build.gradle.kts :

val properties = Properties()
val localPropertiesFile = rootProject.file("local.properties")
if (localPropertiesFile.exists()) {
    localPropertiesFile.inputStream().use { properties.load(it) }
}
val apiKey = properties.getProperty("azeoo.api.key") ?: ""

Option 2 : Configuration de build (non recommandé)​

android {
    buildTypes {
        getByName("debug") {
            buildConfigField("String", "AZEOO_API_KEY", "\"your-dev-key\"")
        }
        getByName("release") {
            buildConfigField("String", "AZEOO_API_KEY", "\"your-prod-key\"")
        }
    }
}

Option 3 : Variables d’environnement​

val apiKey = System.getenv("AZEOO_API_KEY") ?: ""

Dépannage​

Le jeton ne fonctionne pas​

  • Vérifiez que le jeton est correctement copié (sans espaces en trop)
  • Vérifiez que le jeton correspond à la bonne plateforme (Android)
  • Assurez-vous que votre abonnement est actif
  • Contactez le support si le problème persiste

Jeton expiré​

  • Vérifiez votre statut d’abonnement dans le panneau d’administration
  • Renouvelez l’abonnement si nécessaire
  • Générez un nouveau jeton si l’ancien a été révoqué

Besoin d’aide ?​

Prochaines étapes​

Une fois que vous disposez de votre jeton SDK :

  1. Installer le SDK
  2. Intégrer le SDK dans votre application
  3. Configurer le SDK avec votre jeton