| name | da-auth |
| description | Use this when another step needs to call the admin.da.live API, for example before pushing HTML content, listing documents, or triggering a DA preview, and you do not already have a valid DA_TOKEN in scope from an earlier step in the same session. Covers obtaining a valid Adobe IMS access token for the DA (Document Authoring) API. |
| license | Apache-2.0 |
| metadata | {"version":"1.1.0"} |
DA Authentication
Gets a valid Adobe IMS access token and stores it in DA_TOKEN for use in subsequent admin.da.live API calls.
When to Use This Skill
Use this skill whenever you need to call the DA Admin API (admin.da.live) and do not already have a valid token in scope. Common cases:
- Pushing or updating page content in DA
- Listing documents in a DA repository
- Triggering a DA content preview
Do NOT use this skill when:
- You already obtained a
DA_TOKEN earlier in the same session and it has not expired (tokens are valid for ~1 hour with a 60-second buffer)
- The create-site skill is already handling authentication as part of its own flow
- A DA MCP server is active in the session — use its authentication tool directly instead
Prerequisites
- Node.js 18+ installed
- A browser accessible from the machine (for the OAuth flow)
- Network access to
ims-na1.adobelogin.com
Related Skills
- create-site — includes its own DA auth step for new site onboarding; do not invoke da-auth separately within that flow
- content-driven-development — use da-auth before pushing authored content to DA
- building-blocks — use da-auth if test content needs to be pushed to DA for block development
- snowflake — invoke da-auth before Phase 5 (round-trip) so
$DA_TOKEN is set when snowflake PUTs the converted page to DA
- da-content — the reference for what to do with
$DA_TOKEN once you have it (Source API, preview/publish)
Step 1: Check for a Cached Token
Before triggering a browser login, check whether a valid token is already cached.
DA_TOKEN=$(node -e "
const fs = require('fs');
const p = process.env.HOME + '/.aem/da-token.json';
try {
const t = JSON.parse(fs.readFileSync(p, 'utf8'));
if (t.expires_at > Date.now() + 60000) process.stdout.write(t.access_token);
} catch {}
")
If DA_TOKEN is non-empty, skip to Step 3.
Step 2: Obtain a Token (login required)
Choose the option that fits the environment:
Option A (preferred) — da-auth-helper CLI:
The da-auth-helper tool handles the full IMS OAuth 2.0 implicit flow, caches the token at ~/.aem/da-token.json, and prints the token to stdout.
DA_TOKEN=$(npx github:adobe-rnd/da-auth-helper token)
If npx is unavailable or slow, install globally first:
npm install -g github:adobe-rnd/da-auth-helper
DA_TOKEN=$(da-auth-helper token)
This opens a browser window. Instruct the user:
Please complete the Adobe IMS login in the browser window that just opened. The token will be captured automatically once you log in.
Success: DA_TOKEN is a non-empty JWT string starting with eyJ.
Option B — DA MCP server:
If a DA MCP server is configured in the session, use its authentication tool to start the OAuth flow and retrieve the token from the response.
Option C — Manual paste (last resort):
I need an Adobe IMS access token to push content to DA. You can copy one from your browser:
- Open da.live and log in
- Open DevTools → Network tab → find any request to
admin.da.live
- Copy the
Authorization: Bearer <token> value (without the Bearer prefix)
- Paste it here
Step 3: Verify the Token Works
Confirm the token is accepted by the DA API before proceeding:
curl -s -o /dev/null -w "%{http_code}" \
-H "Authorization: Bearer {{DA_TOKEN}}" \
"https://admin.da.live/list/{{ORG}}/{{REPO}}"
Success: HTTP 200. The token is valid — DA_TOKEN is ready for use by the calling skill.
Troubleshooting
| Symptom | Likely cause | Fix |
|---|
DA_TOKEN is empty after Step 1 | No cached token or token expired | Proceed to Step 2 |
| Browser window does not open | npx / da-auth-helper blocked or headless environment | Use Option B (MCP) or Option C (manual paste) |
npx github:adobe-rnd/da-auth-helper fails | Network restrictions on GitHub package registry | Use Option B (DA MCP server) or Option C (manual token paste) |
Step 3 returns 401 | Token expired between steps | Re-run Step 2 to refresh |
Step 3 returns 403 | Authenticated user lacks access to {{ORG}}/{{REPO}} | Ask the user to verify their DA permissions for that org/repo |
Reference
