SOP-002: Create Bot API Keys
Aging Last updated: February 2020| Document Control | |
|---|---|
| SOP ID | SOP-002 |
| Version | 1.5 |
| Status | Active |
| Source | AYCD Zendesk |
Purpose
Create unique Bot API Keys for each bot instance to enable proper captcha solve delivery through AutoSolve.
Critical Concept
┌─────────────────────────────────────────────────────────────────────────────────┐
│ API KEY UNIQUENESS RULE │
├─────────────────────────────────────────────────────────────────────────────────┤
│ │
│ ⚠️ CRITICAL: Each bot and each INSTANCE of a bot needs its own unique │
│ API Key. Using the same key in multiple places will cause solve │
│ delivery failures! │
│ │
│ CORRECT SETUP: │
│ ┌─────────────────────────────────────────────────────────────────────────┐ │
│ │ │ │
│ │ Bot Instance 1 (Cybersole) ───► API Key: "Cybersole-Main" │ │
│ │ Bot Instance 2 (NSB) ───► API Key: "NSB-Main" │ │
│ │ Bot Instance 3 (Cybersole) ───► API Key: "Cybersole-Secondary" │ │
│ │ ▲ │ │
│ │ │ │ │
│ │ Different key for same │ │
│ │ bot, different instance! │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────────────────────┘ │
│ │
│ WRONG SETUP: │
│ ┌─────────────────────────────────────────────────────────────────────────┐ │
│ │ │ │
│ │ Bot Instance 1 (Cybersole) ───► API Key: "MyKey" ❌ │ │
│ │ Bot Instance 2 (NSB) ───► API Key: "MyKey" ❌ │ │
│ │ Bot Instance 3 (Cybersole) ───► API Key: "MyKey" ❌ │ │
│ │ │ │
│ │ Result: Solves delivered randomly, not to correct bot! │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────────────┘Prerequisites
- [x] SOP-001 completed (AutoSolve enabled in OneClick)
- [x] Active AutoSolve subscription
Procedure Flow
┌─────────────────────────────────────────────────────────────────────────────────┐
│ CREATE BOT API KEY FLOW │
├─────────────────────────────────────────────────────────────────────────────────┤
│ │
│ START │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────┐ │
│ │ 1. Access AutoSolve Dashboard │ │
│ │ Option A: OneClick > Go To │ │
│ │ Dashboard │ │
│ │ Option B: aycd.io/account │ │
│ │ #autosolve │ │
│ └───────────────┬─────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────┐ │
│ │ 2. Locate "AutoSolve Bot API │ │
│ │ Keys" section │ │
│ └───────────────┬─────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────┐ │
│ │ 3. Click [Create] │ │
│ └───────────────┬─────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────┐ │
│ │ 4. Enter descriptive name │ │
│ │ Format: BotName-Instance │ │
│ │ Example: "Cybersole-Main" │ │
│ └───────────────┬─────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────┐ │
│ │ 5. Click [Save] │ │
│ └───────────────┬─────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────┐ │
│ │ 6. Copy API Key │ │
│ │ Select from dropdown > Copy │ │
│ └───────────────┬─────────────────┘ │
│ │ │
│ ▼ │
│ SUCCESS │
│ Key ready for bot config │
│ │
└─────────────────────────────────────────────────────────────────────────────────┘Step-by-Step Instructions
Step 1: Access AutoSolve Dashboard
Option A - From OneClick:
- Open OneClick
- Go to the AutoSolve tab
- Click Go To Dashboard
Option B - Direct URL:
- Open browser
- Navigate to:
aycd.io/account#autosolve - Log in if prompted
Step 2: Locate API Keys Section
Find the AutoSolve Bot API Keys section on the dashboard:
┌─────────────────────────────────────────────────────────────────┐
│ AutoSolve Dashboard │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Access Token │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx │ │
│ └─────────────────────────────────────────────────────────┘ │
│ [Copy Access Token] [Reset Access Token] │
│ │
│ ───────────────────────────────────────────────────────────── │
│ │
│ AutoSolve Bot API Keys ◄── This section │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ [+ Create] │ │
│ │ │ │
│ │ Name API Key Actions │ │
│ │ ──────────────────────────────────────────────────── │ │
│ │ (No keys created yet) │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘Step 3: Create New Key
- Click the [+ Create] button
- A dialog will appear
Step 4: Name Your Key
Enter a descriptive, identifiable name:
┌─────────────────────────────────────────────────────────────────┐
│ Create Bot API Key │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Name: │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Cybersole-Main │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ [Cancel] [Save] │
│ │
└─────────────────────────────────────────────────────────────────┘Naming Best Practices:
| Pattern | Example | Use Case |
|---|---|---|
BotName-Instance | Cybersole-Main | Single instance |
BotName-Purpose | NSB-Footsites | Site-specific |
BotName-Machine | Wrath-Desktop | Multi-machine |
BotName-Number | Dashe-01 | Multiple instances |
Step 5: Save the Key
Click [Save] to create the key.
Step 6: Copy Your Key
- The new key appears in the list
- Select it from the dropdown menu
- Click the Copy button
┌─────────────────────────────────────────────────────────────────┐
│ AutoSolve Bot API Keys │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Select Key: [ Cybersole-Main ▼ ] [Copy] │
│ │
│ Created Keys: │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ Name Created Actions │ │
│ │ ─────────────────────────────────────────────────────── │ │
│ │ Cybersole-Main 2024-01-15 [Copy] [Delete] │ │
│ │ NSB-Main 2024-01-15 [Copy] [Delete] │ │
│ │ Wrath-Footsites 2024-01-14 [Copy] [Delete] │ │
│ └──────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘Managing Multiple Keys
Key Organization Diagram
┌─────────────────────────────────────────────────────────────────────────────────┐
│ MULTI-BOT API KEY ORGANIZATION │
├─────────────────────────────────────────────────────────────────────────────────┤
│ │
│ YOUR AUTOSOLVE ACCOUNT │
│ │ │
│ ┌───────────────┼───────────────┐ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │ DESKTOP │ │ LAPTOP │ │ VPS │ │
│ │ MACHINE │ │ MACHINE │ │ MACHINE │ │
│ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘ │
│ │ │ │ │
│ ┌──────┴──────┐ │ │ │
│ │ │ │ │ │
│ ▼ ▼ ▼ ▼ │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │ Cybersole │ │ NSB │ │ Wrath │ │ Dashe │ │
│ │ │ │ │ │ │ │ │ │
│ │ Key: │ │ Key: │ │ Key: │ │ Key: │ │
│ │ CS-Desk │ │ NSB-Desk │ │ Wrath-Lap │ │ Dashe-VPS │ │
│ └───────────┘ └───────────┘ └───────────┘ └───────────┘ │
│ │
│ Each box = Unique API Key │
│ │
└─────────────────────────────────────────────────────────────────────────────────┘Viewing Keys in OneClick
After creating keys, sync them to OneClick:
- In OneClick's AutoSolve tab
- Go to Services view
- Look at the API Keys table on the right
- Click Sync Dashboard to refresh
Verification Checklist
┌─────────────────────────────────────────────────────────────────┐
│ VERIFICATION CHECKLIST │
├─────────────────────────────────────────────────────────────────┤
│ │
│ □ Accessed AutoSolve Dashboard │
│ □ Created API Key with descriptive name │
│ □ Key appears in dashboard list │
│ □ Successfully copied key to clipboard │
│ □ (Optional) Synced to OneClick │
│ │
│ If all checked: Proceed to SOP-003 (Connect Bots) │
│ │
└─────────────────────────────────────────────────────────────────┘Deleting Keys
If you need to remove a key:
- Go to AutoSolve Dashboard
- Find the key in the list
- Click [Delete] next to the key name
- Confirm deletion
- Update any bots that were using that key!
WARNING
Deleting a key will immediately disconnect any bot using it. Create a new key and update the bot before deleting the old one if transitioning.