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 client Azeoo.

Vue d'ensemble​

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

Étapes pour obtenir votre jeton SDK​

1. S'inscrire sur la plateforme Azeoo​

  1. Visitez la plateforme client Azeoo (ou le portail admin Azeoo de votre organisation)
  2. Cliquez sur « Sign Up » ou « Register » si vous n'avez pas de compte
  3. Renseignez les informations de votre organisation :
    • Nom de l'entreprise / organisation
    • Adresse e-mail
    • Coordonnées
    • Informations commerciales

2. Effectuer le paiement​

  1. Après l'inscription, accédez à la section « Billing » ou « Subscription »
  2. Choisissez un abonnement incluant l'accès au SDK :
    • Starter Plan : fonctionnalités SDK de base
    • Professional Plan : accès SDK complet avec fonctionnalités avancées
    • Enterprise Plan : fonctionnalités sur mesure et support dédié
  3. Finalisez le paiement avec votre moyen préféré
  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. Accédez à la section « SDK » ou « Developer » du panneau admin
  3. Vous verrez le tableau de bord de votre organisation

4. Générer le jeton SDK​

  1. Dans la section SDK, cliquez sur « Create New SDK Token » ou « Generate API Key »
  2. Renseignez les détails du jeton :
    • Application Name : nom de votre application Android
    • Platform : sélectionnez « Android »
    • Environment : choisissez « Production » ou « Development »
    • Description : description optionnelle pour votre référence
  3. Cliquez sur « Generate Token »
  4. Votre jeton SDK s'affichera (ex. azeoo_android_xxxxxxxxxxxxxxxxxxxxx)

5. Enregistrer votre jeton en lieu sûr​

⚠️ Important : copiez et enregistrez votre jeton SDK immédiatement. Il ne sera affiché qu'une seule fois pour des raisons de sécurité.

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

Format du jeton​

Les jetons SDK suivent ce format :

azeoo_android_<environment>_<unique_identifier>

Exemple :

azeoo_android_prod_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

Bonnes pratiques de sécurité des jetons​

  1. Ne jamais exposer les jetons dans le code client — utilisez un proxy côté serveur lorsque possible
  2. Stockage sécurisé — Android Keystore ou préférences sécurisées
  3. Rotation régulière — générez de nouveaux jetons et révoquez les anciens
  4. Jetons distincts pour le développement et la production
  5. Surveillez l'utilisation — consultez le panneau admin en cas d'activité inhabituelle
  6. Révoquez immédiatement les jetons compromis

Stocker les jetons sur Android​

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

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

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

Ajoutez à .gitignore :

local.properties

Accès 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 : Build Config (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 copié correctement (pas d'espaces en trop)
  • Vérifiez que le jeton est pour la bonne plateforme (Android)
  • Assurez-vous que votre abonnement est actif
  • Contactez le support si le problème persiste

Jeton expiré​

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

Besoin d'aide ?​

Étapes suivantes​

Une fois votre jeton SDK obtenu :

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