What You Need Before You Start
Setting up an IoD bandwidth scheduler requires three things from your provider:
- • **Client ID and Client Secret** — your NaaS API credentials from the provider portal
- • **Circuit ID** — the unique identifier for your IoD circuit
- • **Sandbox credentials** — a separate set of test credentials for validating your setup before touching production
If you do not have these, contact your provider’s NaaS or IoD support team. They are separate from your portal login credentials.
Step 1: Connect to the Sandbox Environment
Always start in sandbox. IoD providers offer a test environment with a limited set of locations and circuit configurations specifically for integration testing. Connecting to sandbox first lets you verify your credentials, test your scheduling logic, and confirm order submissions without affecting any live circuit.
In Apptifi, flip the Environment toggle in Settings to Sandbox and enter your test credentials. The interface displays an amber banner whenever sandbox mode is active — making it clear you are not connected to production.
Step 2: Enter Your API Credentials
Enter your client ID and client secret in the Lumen IoD API section of Settings. Apptifi stores these credentials locally in a SQLite database on your own infrastructure — they are never transmitted to Apptifi servers.
Once saved, use the “Test Connection” button to verify the credentials authenticate successfully before proceeding.
Step 3: Add Your Circuit
Enter your circuit ID. Apptifi will query the NaaS API to retrieve your circuit’s current bandwidth tier, available tier options, and location metadata. If the query returns an error, double-check the circuit ID format — it typically follows a specific alphanumeric pattern from your provider.
Step 4: Create Your First Bandwidth Schedule
Open the visual calendar and create a new event. Define:
- • **Start time** — when the bandwidth change should take effect (e.g., 6:00 PM)
- • **End time** — when to return to the previous tier (e.g., 7:30 AM)
- • **Bandwidth tier** — the target tier for this window (e.g., 100 Mbps)
- • **Recurrence** — daily, weekdays only, or custom schedule
Build in a 15–30 minute buffer before your actual peak window starts. API orders process quickly, but the buffer protects against any edge-case delays.
Step 5: Validate in Sandbox
With sandbox active, submit the event. Apptifi will submit a bandwidth order to the test API and display the order status in real time. Confirm:
- • The order submits without authentication errors
- • The order status transitions from “Submitted” to “Completed”
- • The circuit state in the inventory panel reflects the new tier
If the sandbox API returns errors, check the event log for the full API response. Common issues are credential format mismatches or unsupported tier/location combinations in the sandbox environment.
Step 6: Switch to Production and Go Live
Once sandbox validation is complete, switch the Environment toggle to Production, enter your production credentials, and verify the connection. Your scheduled events will now submit orders to the live circuit at the configured times.
Monitor the first few live events closely — check the order status panel after each transition and confirm your IoD bill for the first month reflects the expected tier changes.