SYSTEM$VERIFY_EXTERNAL_OAUTH_TOKEN

SYSTEM$VERIFY_EXTERNAL_OAUTH_TOKEN

외부 OAuth 액세스 토큰이 유효한지, 아니면 만료되어 재생성해야 하는지 판별하는 시스템 함수예요.

출처: Snowflake SQL Reference

본문

Syntax

SYSTEM$VERIFY_EXTERNAL_OAUTH_TOKEN( '<access_token>' )

Arguments

access_token:

OAuth 2.0 서버가 생성한 외부 OAuth 액세스 토큰이에요.

Output

이 함수는 이유와 함께 검증 결과를 알려주는 JSON 객체를 반환해요. 쿼리 결과는 토큰 자체를 표시해서는 안 돼요. 예를 들어, 잘못된 토큰은 Snowflake에서 민감한 정보가 불필요하게 노출되지 않도록 결과에 마스킹된 토큰을 반환해야 해요.

| Column Name | Data Type | Description | | Validation Result | String | 유효한 토큰은 Passed를 반환해요. 잘못된 토큰은 Failed를 반환해요. | | Reason | String | 유효한 토큰은 Issuer URL과 사용자를 반환해요. 잘못된 토큰은 액세스 토큰의 문제(예: EXTERNAL_OAUTH_JWS_INVALID_FORMAT)를 알려줘요. |

Examples

다음 예제는 유효한 외부 OAuth 토큰 결과를 반환해요:

SELECT SYSTEM$VERIFY_EXTERNAL_OAUTH_TOKEN('<access_token>');

+-----------------------------------------------------------------------------------------------+
| Token Validation finished.{"Validation Result":"Passed","Issuer":"<URL>","User":"<username>"} |
+-----------------------------------------------------------------------------------------------+

더 알아보기 (Learn more)