トークンを使用して受信イベントを DevOps 変更速度管理に送信するための Webhook の作成

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：2分

    • トークンベースの認証を使用して DevOps 変更速度管理に受信イベントを送信する Webhook を作成する必要があります。

    受信イベントを ServiceNow インスタンスに送信するには、次の API エンドポイント構造を使用する必要があります。 
    <instance_url>/api/sn_devops/v2/devops/tool/{capability}?toolId=<toolId>
    ここで、機能は計画、コード、またはオーケストレーションです。

    ツール ID、インスタンス URL などの詳細をコピーするには、ツールレコードから [手動で構成 ] を選択するか、ツールのオンボーディング中に構成ステップで選択します。その後、適切な フィールドで コピー を選択して 、値をクリップボードにコピーできます。フィールドラベルが [ コピー済み] に変わりますが、何度でもコピーできます。次の画像は、DevOps 変更速度管理の GitHub ツールの値をコピーできるページを示しています。GitHub で Webhook を手動で構成

    トークン認証の場合、エンドポイントが保護されているため、認証ヘッダーまたはクエリパラメーターの一部としてトークンを渡す必要があります。次のいずれかの方法を使用できます。
    • 次の形式を使用して、トークンをヘッダーとして渡します。 ヘッダー名:認証 ヘッダー値:sn_devops。DevOpsToken <ToolId>:<Token> (<ToolId> はツールの ID、<Token> はツールレコードページからコピーされた認証トークンです。
    • URL でトークンをクエリパラメーターとして渡します: <instance_url>/api/sn_devops/v2/devops/tool/{capability}?toolId=<toolId>&ni.nolog.token=<Token> ここで、<ToolId> はツールの ID、<Token> はツールレコードページからコピーされた認証トークンです。

    ベーシック認証の場合は、V1 エンドポイント https://user:password@<instance_url>/api/sn_devops/v1/devops/tool/{capability}?toolId=<toolId> を使用できます。ユーザー名とパスワードを ServiceNow 認証情報に置き換えます。

    カスタムツールまたは別の認証方法がある場合は、独自の認証ロジックを実装できます。たとえば、ハンドラークラスに authenticateToken 関数を実装できます。関数はトークンを検証し、適切な認証を確認する必要があります。独自の認証ロジックを実装するには、ServiceNow の admin ロールが必要です。