adobe-install-auth

name	adobe-install-auth
description	Install and configure Adobe Developer Console OAuth Server-to-Server credentials. Use when setting up a new Adobe integration, configuring API credentials, or initializing Adobe SDKs (Firefly Services, PDF Services, I/O Runtime). Trigger with phrases like "install adobe", "setup adobe", "adobe auth", "configure adobe credentials", "adobe developer console".
allowed-tools	Read, Write, Edit, Bash(npm:*), Bash(pip:*), Grep
version	1.6.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","design","adobe"]
compatibility	Designed for Claude Code

Adobe Install & Auth

Overview

Set up Adobe Developer Console OAuth Server-to-Server credentials and install the appropriate SDK for your use case. As of January 2025, JWT (Service Account) credentials are deprecated -- all new integrations must use OAuth Server-to-Server.

Prerequisites

• Node.js 18+ or Python 3.10+
• Adobe Developer Console account (https://developer.adobe.com/console)
• An Adobe organization with API access entitlements
• Admin or Developer role in Adobe Admin Console

Instructions

Step 1: Create Project in Adobe Developer Console

1. Go to https://developer.adobe.com/console
2. Click Create new project > Add API
3. Select the API you need (e.g., Firefly Services, PDF Services, Creative Cloud Libraries)
4. Choose OAuth Server-to-Server credential type
5. Select the product profiles to scope access
6. Save your client_id, client_secret, and scopes

Step 2: Install the SDK for Your Use Case

# Firefly Services (Photoshop API, Lightroom API, Firefly API)
npm install @adobe/firefly-apis @adobe/photoshop-apis @adobe/lightroom-apis

# PDF Services (create, extract, convert, generate documents)
npm install @adobe/pdfservices-node-sdk

# Adobe I/O Events (webhooks, event-driven)
npm install @adobe/aio-lib-events

# Adobe I/O SDK (App Builder, Runtime actions)
npm install @adobe/aio-sdk

# Adobe I/O CLI (global install for aio commands)
npm install -g @adobe/aio-cli

# Python — PDF Services
pip install pdfservices-sdk

Step 3: Configure OAuth Server-to-Server Credentials

# .env (NEVER commit — add to .gitignore)
ADOBE_CLIENT_ID=your_client_id_from_console
ADOBE_CLIENT_SECRET=your_client_secret_from_console
ADOBE_SCOPES=openid,AdobeID,read_organizations,firefly_api,ff_apis
ADOBE_IMS_ORG_ID=your_org_id@AdobeOrg

Step 4: Generate Access Token

// src/adobe/auth.ts
import 'dotenv/config';

  {
  : ;
  : ;
  : ; 
}

 : { : ; :  } |  = ;

   (): <> {
  
   (cachedToken && cachedToken. > .() + ) {
     cachedToken.;
  }

   response =  (, {
    : ,
    : { :  },
    :  ({
      : process..!,
      : process..!,
      : ,
      : process..!,
    }),
  });

   (!response.) {
     error =  response.();
      ();
  }

   :  =  response.();
  cachedToken = {
    : data.,
    : .() + data. * ,
  };

   cachedToken.;
}