GlideOAuthClient - スコープ指定、グローバル

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:4分
  • GlideOAuthClient API は、OAuth リフレッシュトークンとアクセストークンを要求および取り消すためのメソッドを提供します。

    この API は、グローバルスクリプトおよびスコープ付きスクリプトで使用できます。スコープ付きスクリプトでは、 sn_auth 名前空間識別子を使用します。

    GlideOAuthClient:getToken(文字列 requestID, 文字列 oauthProfileID)

    クライアントのアクセストークンとリフレッシュトークンを取得します。

    表 : 1. パラメーター
    名前 タイプ 説明
    requestID 文字列 OAuth エンティティプロファイル [oauth_entity_profile] テーブルを参照する OAuth 要求者プロファイル [oauth_requestor_profile] テーブルからの要求 ID。
    oauthプロファイル ID 文字列 OAuth エンティティプロファイル [oauth_entity_profile] テーブルの OAuth プロファイル ID。
    表 : 2. 返される内容
    タイプ 説明
    GlideOAuthToken クライアントのアクセストークンとリフレッシュトークン。

    このコード例は、インスタンスデータベースからアクセストークンとリフレッシュトークンを取得する方法を示しています。

    function dumpToken(token) {
      if(token) {
         gs.info("AccessToken:" + token.getAccessToken());
         gs.info("AccessTokenExpiresIn:" + token.getExpiresIn());
         gs.info("RefreshToken:" + token.getRefreshToken());
      }
    }
    
    var oAuthClient = new  sn_auth.GlideOAuthClient();
    var token = oAuthClient.getToken('248e3017c302301089a7dd5c2840dda5', '9c4e78d3c302301089a7dd5c2840dd76');
    dumpToken(token);

    出力:

    *** Script: AccessToken:6MRxD3TRYYvIaoKr-JCy3KiaOxBPu4C9k8oafo3MYf9q8zDyHQr8UzMSM3Md2alfaES1rzSYe5ydqgbOwpm7TA
    *** Script: AccessTokenExpiresIn:1207
    *** Script: RefreshToken:sc0iTK-0PcVkRi14HXPM3vT0FyOPO8iCqC10huQoDSSLBGUSnmEv_fUfJzGWCWBb_StsXIOz6r8qF-hRhURWTA

    GlideOAuthClient - requestToken(String clientName, String jsonString)

    JSON 形式でエンコードされた要求パラメーターを使用して、クライアントのトークンを取得します。

    表 : 3. パラメーター
    名前 タイプ 説明
    クライアント名 文字列 クライアント名。
    jsonString 文字列 クライアントの JSON 文字列。
    表 : 4. 返される内容
    タイプ 説明
    GlideOAuthClientResponse クライアントのトークン。

    この例では、JSON 形式でエンコードされた要求パラメーターを使用して、リソース所有者のパスワード権限許可タイプの要求を示しています。

    
    var oAuthClient = new GlideOAuthClient();
    var params ={grant_type:"password", username:"itil", password:'itil'};
    var json =new JSON();
    var text = json.encode(params);
    var tokenResponse = oAuthClient.requestToken('TestClient', text);
    var token = tokenResponse.getToken();
    
    gs.log("AccessToken:"+ token.getAccessToken());
    gs.log("AccessTokenExpiresIn:"+ token.getExpiresIn());
    gs.log(" RefreshToken:"+ token.getRefreshToken());
    

    GlideOAuthClient - requestTokenByRequest(文字列 clientName, GlideOAuthClientRequest request)

    クライアント名と要求が GlideOAuthClientResponse オブジェクトに設定されて、クライアントのトークンを取得します。

    表 : 5. パラメーター
    名前 タイプ 説明
    クライアント名 文字列 クライアント名。
    要求 GlideOAuthClientRequest 要求。
    表 : 6. 返される内容
    タイプ 説明
    GlideOAuthClientResponse クライアントのトークン。

    GlideOAuthClient - revokeToken(文字列 clientName, 文字列 accessToken, 文字列 refreshToken, GlideOAuthClientRequest request)

    要求とオプションのヘッダーパラメーターを GlideOAuthClientRequest オブジェクトに設定して、クライアントのアクセストークンまたはリフレッシュトークンを取り消します。

    表 : 7. パラメーター
    名前 タイプ 説明
    クライアント名 文字列 クライアント名。
    accessToken 文字列 アクセストークン。
    refreshToken 文字列 リフレッシュトークン。
    要求 GlideOAuthClientRequest 要求。
    表 : 8. 返される内容
    タイプ 説明
    GlideOAuthClientResponse クライアントのトークン。