---
title: "JSON Web Token"
slug: "globaledge-jwt"
updated: 2026-05-21T09:01:38Z
published: 2026-05-21T09:03:11Z
canonical: "guide-gov.ncloud-docs.com/globaledge-jwt"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# JSON Web Token

<p class="platform-info type-classic-vpc">Classic/VPC 환경에서 이용 가능합니다.</p>

인증에 필요한 JSON Web Token(JWT) 인증 방식을 설명합니다.

## Header (헤더)<a name="Header헤더"></a>

Header 구성은 다음과 같습니다.

* alg: 서명(signature) 생성 시 사용한 해시 알고리즘
    * HS256 지원(HMAC SHA256) 
* typ: 토큰 타입
   * JWT 형식만 지원

Header 사용 예시는 다음과 같습니다.
``` 
{
    "alg": "HS256",
     "typ": "JWT"
}
```

## Payload (내용)<a name="Payload내용"></a>

Payload 구성은 다음과 같습니다.

* path: 토큰의 적용 대상 URL 경로
    * 필수값
    * \* 사용 가능
* exp: 토큰 만료 시간(expiration)
    * 옵션값
    * NumericDate 형식 <예시> unix timestamp
* nbf: 토큰 활성 시간(Not Before)
    * 옵션값
    * NumericDate 형식 <예시> unix timestamp
* cip: 클라이언트 IP 대상
    * 옵션값
    * CIDR 사용 가능

Payload 사용 예시는 다음과 같습니다.
``` 
{
    "path": "/foo/bar/example.mp4", 
    "exp": 1672455600, 
    "nbf": 1669258800, 
    "cip": "192.168.200.0/24"
}
```

## Signature (서명)<a name="Signature서명"></a>

Signature를 생성하는 방법은 다음과 같습니다.

1. Header와 Payload를 각각 Base64 URL로 인코딩해 주십시오.
    ``` 
    # as-is
    { 
        "alg": "HS256", 
        "typ": "JWT" 
    } 
    
    # to-be 
    {"alg":"HS256","typ":"JWT"} 
    
    # Base64 URL 인코딩 
    eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9
    ```
    :::(Info) (참고)
    Base64 URL로 인코딩하는 과정에서 JSON의 공백이나 엔터값은 제거됩니다.
    :::
2. 마침표(.)를 구분자로 사용하여 인코딩된 Header와 Payload를 연결해 주십시오.
3. 연결된 문자열을 Secure key와 함께 알고리즘(HMAC SHA256)으로 해시값을 추출해 주십시오.

:::(Info) (참고)
Signature 생성 및 검증을 [https://jwt.io/](https://jwt.io/){target="_blank"}에서 테스트할 수 있습니다. 
![globaledge-jwt-1](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/globaledge-jwt-1.png){height="" width="35%"}
:::



## 사용 형식<a name="사용형식"></a>

사용 형식과 참고할 수 있는 예시는 다음과 같습니다.

* Query Token
* JWT 토큰을 쿼리스트링에 사용하여 요청 가능
* 사용 예시
    ```
    # Query 형태 
    https://example.com/foo/bar/example.mp4?<JWT 토큰 이름>=<JWT token> 

    # 예시
    https://example.com/foo/bar/example.mp4?globaledgejwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXRoIjoiL2Zvby9iYXIvZXhhbXBsZS5tcDQiLCJleHAiOjE2NzI0NTU2MDAsIm5iZiI6MTY2OTI1ODgwMCwiY2lwIjoiMTkyLjE2OC4yMDAuMC8yNCJ9.65cikBSh0rsrH1-2Q87HSK7v3-KExYe-B1wpaTZTQ2o
    ```