연동 문서

npm install @tigrison/authhub-client

import { createAuthHubClient } from "@tigrison/authhub-client";

const authhub = createAuthHubClient({
  issuer: "http://127.0.0.1:43177",
  clientId: "YOUR_CLIENT_ID",
  clientSecret: "YOUR_CLIENT_SECRET",
  redirectUri: "https://your-app.example/callback",
  scopes: ["openid", "profile", "email", "offline_access"],
});

// 서비스 토큰
const serviceTokens = await authhub.exchangeClientCredentials();

// 로그인 URL (PKCE)
const { codeVerifier, codeChallenge } = await authhub.createPkce();
const loginUrl = authhub.buildAuthorizationUrl({ codeChallenge });

// JWT 검증
import { verifyAccessToken } from "@tigrison/authhub-client/verify";
const claims = await verifyAccessToken(accessToken, {
  issuer: "http://127.0.0.1:43177",
  audience: "YOUR_CLIENT_ID",
});

// 사용자 디렉토리 (directory:read)
const dirTokens = await authhub.exchangeClientCredentials({
  scope: "openid directory:read",
});
const directory = await authhub.listDirectoryUsers(dirTokens.access_token, {
  limit: 20,
});

// 기본 아바타 목록 (인증 불필요) — TeamWiki 등 선택 UI용 절대 URL
const { presets } = await authhub.listAvatarPresets();
// presets[0].picture → http://127.0.0.1:43177/avatars/presets/01.webp

// 선택·업로드 (사용자 액세스 토큰)
await authhub.setAvatarPreset(accessToken, presets[0].id);
await authhub.uploadAvatar(accessToken, avatarFile);
const me = await authhub.getUserInfo(accessToken);
// me.picture

// Tenant 조직도 (directoryToken + siteId)
const siteAuth = createAuthHubClient({
  issuer: "http://127.0.0.1:43177",
  clientId: "YOUR_CLIENT_ID",
  directoryToken: process.env.AUTHHUB_DIRECTORY_TOKEN,
  siteId: "YOUR_SITE_ID",
});
const { orgUnits } = await siteAuth.listOrgUnits();
const { members } = await siteAuth.listOrgUnitMembers("DEPT_CODE");

import { createAuthHubClient } from "@tigrison/authhub-client";

// Route Handler / Server Action — 브라우저에 session·secret 금지
const authhub = createAuthHubClient({
  issuer: "http://127.0.0.1:43177",
  clientId: process.env.AUTHHUB_CLIENT_ID!,
  clientSecret: process.env.AUTHHUB_CLIENT_SECRET!,
  scopes: ["openid", "profile", "email", "offline_access"],
});

const tokens = await authhub.exchangeExternalSession({
  provider: "tigris",
  session: tigrisSid, // searchParams._tigris_sid
  siteId, // 티그리스가 넘기면
  scope: ["openid", "profile", "email", "offline_access"],
});
// httpOnly 쿠키 등에 저장 후 URL에서 _tigris_sid 제거

1. 콘솔에서 애플리케이션을 만들고 client_id / secret을 보관합니다.
2. AuthHub 로그인 화면: 사용자를 `http://127.0.0.1:43177/oauth/authorize`로 보내고, 콜백의 코드를 `/oauth/token`과 교환합니다.
3. 앱 자체 로그인: 콘솔에서 “앱 자체 로그인”을 켠 뒤, 해당 시스템이 자기 화면에서 아이디·비밀번호를 받아 `grant_type=password`로 `/oauth/token`을 호출합니다. 로컬 계정 실패 시 티그리스 아이디/암호로 폴백합니다 (`TIGRIS_PASSWORD_FALLBACK`).
4. 외부 세션 교환: 콘솔에서 “외부 세션 교환”을 켠 confidential 웹 앱이, URL의 `_tigris_sid` 등을 서버에서만 exchangeExternalSession() / grant_type=external_session(provider로 IdP 구분)로 교환합니다.
5. 서버 워커는 `client_credentials`로 토큰을 받습니다. 사용자 로그인 화면이 필요 없습니다.
6. Tenant 조직도: `AUTHHUB_DIRECTORY_TOKEN`과 `siteId`로 `/directory/org-units`를 호출합니다.
7. 사용자 디렉토리: `directory:read` 스코프 토큰으로 `/api/v1/directory/users`를 호출합니다.
8. 기본 아바타: 인증 없이 `/api/v1/avatars/presets`(또는 SDK listAvatarPresets())로 미모지 목록·절대 URL을 받고, 적용만 사용자 토큰으로 setAvatarPreset()합니다.
9. 리소스 서버는 `http://127.0.0.1:43177/.well-known/jwks.json`의 공개키로 JWT를 검증합니다. 매 요청마다 AuthHub를 호출하지 않아도 됩니다.

import { createAuthHubClient } from "@tigrison/authhub-client";

const authhub = createAuthHubClient({
  issuer: "http://127.0.0.1:43177",
  clientId: "YOUR_CLIENT_ID",
});

// 목록·절대 URL (인증 없음)
const { presets } = await authhub.listAvatarPresets();
const listUrl = await authhub.getAvatarPresetsEndpoint();

// 적용 (사용자 액세스 토큰)
await authhub.setAvatarPreset(accessToken, presets[0].id);