Aller au contenu principal

Getting SDK Token

To use the Azeoo SDK, you need to obtain an API key (SDK token) from the Azeoo client platform admin panel.

Overview​

The SDK token is a unique identifier that authenticates your application with the Azeoo services. This token is required to initialize the SDK and access all features.

Steps to Get Your SDK Token​

1. Register for Azeoo Platform​

  1. Visit the Azeoo Client Platform (or your organization's Azeoo admin portal)
  2. Click on "Sign Up" or "Register" if you don't have an account
  3. Fill in your organization details:
    • Company/Organization name
    • Email address
    • Contact information
    • Business details

2. Complete Payment​

  1. After registration, navigate to the "Billing" or "Subscription" section
  2. Choose a subscription plan that includes SDK access:
    • Starter Plan: Basic SDK features
    • Professional Plan: Full SDK access with advanced features
    • Enterprise Plan: Custom features and dedicated support
  3. Complete the payment process using your preferred method
  4. Wait for payment confirmation (usually instant)

3. Access Admin Panel​

  1. Once payment is confirmed, log in to your account
  2. Navigate to the "SDK" or "Developer" section in the admin panel
  3. You'll see your organization dashboard

4. Generate SDK Token​

  1. In the SDK section, click on "Create New SDK Token" or "Generate API Key"
  2. Fill in the token details:
    • Application Name: Name of your Android app
    • Platform: Select "Android"
    • Environment: Choose "Production" or "Development"
    • Description: Optional description for your reference
  3. Click "Generate Token"
  4. Your SDK token will be displayed (e.g., azeoo_android_xxxxxxxxxxxxxxxxxxxxx)

5. Save Your Token Securely​

⚠️ Important: Copy and save your SDK token immediately. It will only be shown once for security reasons.

  • Store it in a secure location
  • Use local.properties or gradle.properties for local development
  • Never commit tokens to version control
  • Consider using a secrets management service for production

Token Format​

SDK tokens follow this format:

azeoo_android_<environment>_<unique_identifier>

Example:

azeoo_android_prod_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

Token Security Best Practices​

  1. Never expose tokens in client-side code - Use server-side proxy when possible
  2. Store in secure storage - Use Android Keystore or secure preferences
  3. Rotate tokens regularly - Generate new tokens and revoke old ones
  4. Use different tokens for development and production
  5. Monitor token usage - Check the admin panel for unusual activity
  6. Revoke compromised tokens immediately

Storing Tokens in Android​

Create or edit local.properties in your project root:

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

Add to .gitignore:

local.properties

Access in 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") ?: ""
android {
    buildTypes {
        getByName("debug") {
            buildConfigField("String", "AZEOO_API_KEY", "\"your-dev-key\"")
        }
        getByName("release") {
            buildConfigField("String", "AZEOO_API_KEY", "\"your-prod-key\"")
        }
    }
}

Option 3: Environment Variables​

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

Troubleshooting​

Token Not Working​

  • Verify the token is copied correctly (no extra spaces)
  • Check if the token is for the correct platform (Android)
  • Ensure your subscription is active
  • Contact support if issues persist

Token Expired​

  • Check your subscription status in the admin panel
  • Renew your subscription if needed
  • Generate a new token if the old one was revoked

Need Help?​

Next Steps​

Once you have your SDK token:

  1. Install the SDK
  2. Integrate into your app
  3. Configure the SDK with your token