を使用した ServiceNow インスタンスへの認証 ServiceNow SDK

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:6分
  • ServiceNowインスタンスに対して認証し、ServiceNow SDKを使用してシステム上のインスタンスにアクセスするためのユーザー認証情報を保存します。

    ServiceNow SDKをインストールした後、ServiceNow SDKコマンドラインインターフェイス (CLI) を使用してインスタンスに対して認証し、アプリケーションの開発とインスタンスへの展開を開始できます。アプリケーション開発には、非本番インスタンスを使用する必要があります。

    基本認証情報または OAuth 2.0 認証情報を使用して、インスタンスに対する認証を行うことができます。OAuth 2.0 認証を使用するには、インスタンスに ServiceNow IDE (バージョン 1.1 以降) がインストールされているか、必要な XML 構成がインポートされている必要があります。デフォルトでは、 Yokohama リリースのインスタンスには ServiceNow IDE バージョン 1.1.4 が含まれており、 ServiceNow SDK での OAuth 2.0 認証の使用をサポートしています。

    のベーシック認証を使用した ServiceNow インスタンスへの認証 ServiceNow SDK

    ベーシック認証を使用して、ServiceNow SDKServiceNowインスタンスに接続します。

    始める前に

    必要なロール:admin

    このタスクについて

    この手順では、ServiceNow SDK コマンドラインインターフェイス (CLI) を使用します。コマンドラインツールから「 now-sdk --help 」と入力すると、使用可能なコマンドとグローバルオプションに関する情報を取得できます。コマンドとそのパラメーターに関する追加情報を取得するには、コマンドと --help または -h を入力します。たとえば、now-sdk auth --help などです。CLI の詳細については、「 ServiceNow SDK CLI」を参照してください。

    手順

    1. システムでコマンドラインツールを開きます。
    2. auth コマンドで認証するインスタンスを指定します。
      now-sdk auth save <alias> --type basic

      例:
      now-sdk auth save devuser1 --type basic --default true
    3. プロンプトで、ターゲットインスタンスの URL を入力します。
    4. ServiceNowユーザー名を入力します。

      admin ロールが割り当てられている必要があります。

    5. パスワードを入力します。

    タスクの結果

    エイリアスと認証情報は、システムのデバイスキーチェーンまたは認証情報マネージャーに保存されます。 エイリアスは、 createconvertfetch、および deploy コマンドによる認証に使用できます。

    次のタスク

    スコープ対象のアプリケーションを作成するか、既存のアプリケーションを ServiceNow SDK で使用できるように変換します。詳細については、 を使用してアプリケーションを作成 する ServiceNow SDK または を参照してください。

    を使用した OAuth 2.0 認証用の ServiceNow インスタンスの構成 ServiceNow SDK

    インスタンスへの ServiceNow SDK で OAuth 2.0 認証を使用するように構成をインポートします。

    始める前に

    重要:
    この手順は、 ServiceNow IDE (バージョン 1.1 以降) がインストールされていないインスタンスにのみ必要です。デフォルトでは、 Yokohama リリースのインスタンスには ServiceNow IDE バージョン 1.1.4 が含まれており、 ServiceNow SDK での OAuth 2.0 認証の使用をサポートしています。

    デフォルトのシステムアドミニストレーター (admin) ユーザーは、 ServiceNow SDK で OAuth 2.0 認証用のインスタンスを構成するには、特権 security_admin ロールに昇格する必要があります。詳細については、「Elevate to a privileged role」を参照してください。

    必要なロール:security_admin

    手順

    1. ServiceNow コミュニティの記事「Configuring ServiceNow SDK for OAuth 2.0 authentication (SSO) (OAuth 2.0 認証 (SSO) 用の ServiceNow SDK の構成)」に移動します。
    2. 添付の ZIP ファイルをダウンロードし、その内容を解凍します。
    3. XML をインスタンスにインポートします。
      1. インスタンスから任意のリストに移動します。
        XML ファイルにはレコードの宛先テーブル名が含まれているため、任意のリストを使用できます。
      2. 列のタイトルを選択して長押し (または右クリック) し、[XML のインポート] を選択します。
      3. [XML のインポート] フォームで、[ ファイルを選択 ] を選択し、ダウンロードした XML ファイルのいずれかを選択します。
      4. [アップロード] を選択します。
      5. XML ファイルごとにこれらの手順を繰り返します。
      詳細については、「Import data from XML」を参照してください。

    タスクの結果

    開発者は、 ServiceNow SDK で OAuth 2.0 を使用してインスタンスに対する認証を行うことができます。

    で OAuth 2.0 を使用して ServiceNow インスタンスに対して認証する ServiceNow SDK

    OAuth 2.0 認証を使用して、ServiceNow SDKServiceNow インスタンスに接続します。

    始める前に

    OAuth 2.0 認証を使用するには、インスタンスに ServiceNow IDE (バージョン 1.1 以降) がインストールされているか、必要な XML 構成がインポートされている必要があります。デフォルトでは、 Yokohama リリースのインスタンスには ServiceNow IDE バージョン 1.1.4 が含まれており、 ServiceNow SDK での OAuth 2.0 認証の使用をサポートしています。詳細については、「を使用した OAuth 2.0 認証用の ServiceNow インスタンスの構成 ServiceNow SDK」を参照してください。

    必要なロール:admin

    このタスクについて

    この手順では、ServiceNow SDK コマンドラインインターフェイス (CLI) を使用します。コマンドラインツールから「 now-sdk --help 」と入力すると、使用可能なコマンドとグローバルオプションに関する情報を取得できます。コマンドとそのパラメーターに関する追加情報を取得するには、コマンドと --help または -h を入力します。たとえば、now-sdk auth --help などです。CLI の詳細については、「 ServiceNow SDK CLI」を参照してください。

    手順

    1. システムでコマンドラインツールを開きます。
    2. auth コマンドで認証するインスタンスを指定します。
      now-sdk auth save <alias> --type oauth

      例:
      now-sdk auth save devuser1 --type oauth --default true
    3. プロンプトで、ターゲットインスタンスの URL を入力します。
      ServiceNow SDKは、インスタンスで認証するために Web ブラウザーを開きます。
    4. 現在ログインしていない場合は、開いた Web ページに移動してインスタンスにログインします。
    5. [ 承認] を選択して、 ServiceNow SDK インスタンスへの接続を許可します。
      ページが更新され、認証コードが表示されます。
    6. [ コピー ] を選択して、提供された認証コードをコピーします。
    7. システムのコマンドラインツールに、認証コードを貼り付けます。

    タスクの結果

    エイリアスと認証情報は、システムのデバイスキーチェーンまたは認証情報マネージャーに保存されます。 エイリアスは、 createconvertfetch、および deploy コマンドによる認証に使用できます。

    次のタスク

    スコープ対象のアプリケーションを作成するか、既存のアプリケーションを ServiceNow SDK で使用できるように変換します。詳細については、 を使用してアプリケーションを作成 する ServiceNow SDK または を参照してください。