seoltab.js

Seoltab SDK for JavaScript

설치하기

Using NPM

npm install @seoltab/sdk

Using Yarn

yarn add @seoltab/sdk

Using CDN

<script src="https://unpkg.com/@seoltab/sdk"></script>

시작하기

Seoltab.init()

JavaScript SDK 초기화 예제입니다.

const Seoltab = require("@seoltab/sdk");

Seoltab.init({
  clientId: "31024ffa-5ef0-413e-9bf5-f1761638b6d8",
});

입력인자

| Name | Type | Required | Description | | ---------- | :----: | :------: | --------------- | | clientId | string | Y | 애플리케이션 ID |

기능 명세

Seoltab.Auth.authorize()

사용자가 앱에 로그인할 수 있도록 인가 코드를 요청하는 함수입니다. 인가 코드를 받을 수 있는 서버 개발이 필요합니다.

Seoltab.Auth.authorize({
  redirectUri: "https://seoltab.com/authorize",
});

입력인자

| Name | Type | Required | Description | | ------------- | :----: | :------: | -------------------- | | redirectUri | string | N | 인가 코드를 받을 URI | | scope | string | N | 추가 동의 받을 항목 |

Seoltab.Auth.getClientId()

사용 중인 Client ID

Seoltab.Auth.getClientId();

출력결과

31024ffa-5ef0-413e-9bf5-f1761638b6d8

Seoltab.Auth.token()

사용자가 앱에 로그인할 수 있도록 토큰을 요청하는 함수입니다. 토큰을 받을 수 있는 서버 개발이 필요합니다.

Seoltab.Auth.token({
  grantType: "authorization_code",
  redirectUri: "https://seoltab.com/authorize",
  code: "128ba3b3-f2ca-4a33-afaf-aae20ba79093",
});

입력인자

| Name | Type | Required | Description | | ------------- | :----: | :------: | ------------------------- | | grantType | string | Y | authorization_code로 고정 | | redirectUri | string | N | 인가 코드를 받은 URI | | code | string | N | 인가 코드 |

출력결과

{
  access_token: '...',
  expires_in: 3599,
  id_token: '...',
  scope: 'openid',
  token_type: 'Bearer'
}

Seoltab.Auth.tokenInfo()

로그인된 토큰의 payload를 요청하는 함수입니다. 검증된 토큰만 payload를 반환합니다.

Seoltab.Auth.tokenInfo({
  accessToken: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6NDI0OTk5L ...",
});

입력인자

| Name | Type | Required | Description | | ------------- | :----: | :------: | ----------- | | accessToken | string | Y | JWT |

출력결과

{
  "iss": "accounts.seoltab.com",
  "aud": "seoltab.com",
  "sub": "123456",
  "email": "...",
  "name": "...",
  "iat": 1610042222,
  "exp": 1610042222,
  "jti": "822222212332dasdaaaaadc"
}

Seoltab.Auth.decodeJwt()

JWT 토큰의 payload를 요청하는 함수입니다. 검증 없이 payload를 반환합니다.

Seoltab.Auth.decodeJwt(
  "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6NDI0OTk5L ..."
);

입력인자

| Name | Type | Required | Description | | ------ | :----: | :------: | ----------- | | arg0 | string | Y | JWT |

출력결과

{
  "iss": "accounts.seoltab.com",
  "aud": "seoltab.com",
  "sub": "123456",
  "email": "...",
  "name": "...",
  "iat": 1610042222,
  "exp": 1610042222,
  "jti": "822222212332dasdaaaaadc"
}