メインコンテンツまでスキップ

ServiceNow インジェスト パイプラインのトラブルシューティング

備考

プレビュー

ServiceNow コネクタは パブリック プレビュー段階です。

この記事では、 Databricks LakeFlow Connect でマネージド ServiceNow インジェスト コネクタを使用する際の一般的な問題とその解決方法について説明します。

認証エラー

エラー:

com.databricks.pipelines.execution.conduit.common.DataConnectorException: [SERVICENOW_CONNECTION_ERROR.OAUTH_TOKEN_EXCHANGE] Failed to authenticate to ServiceNow. This can be caused by issues with your UC credentials, ServiceNow OAuth setup, and more...

ステップ 1

Unity Catalog 接続の作成時に、正しいユーザー名、パスワード、クライアント ID、およびクライアント シークレットを指定したことを確認します。

注記

ServiceNowへの認証用のユーザー名とパスワードは、必ずしもSSO用の個人用ユーザー名とパスワードではありません。これらは、外部サービスでの認証とインジェストを目的としたユーザーに関連付けられたユーザー名とパスワードの値です。

  1. Databricks ワークスペースのサイドバーで、[カタログアイコン カタログ] をクリックします。

  2. [カタログ ] ウィンドウの上部にある [歯車アイコン] 歯車アイコンをクリックし、メニューから [ 接続 ] を選択します。

    または、[ クイック アクセス ] ページで [ 外部データ > ] ボタンをクリックし、[ 接続 ] タブに移動します。

  3. 接続の名前をクリックします。

    接続の詳細は、[ 概要 ] タブに一覧表示されます。

ステップ 2

認証するユーザーに admin ロールがあることを確認します。また、Databricks では、認証するユーザーに snc_read_only ロールを付与して、アクセス許可をさらに制限することをお勧めします。

ステップ 3

認証するユーザーが アクティブ としてマークされていることを確認します。

  1. ServiceNow で、[ 組織] > [ユーザー ] をクリックします。

  2. 認証に使用する予定のユーザーを選択します。

  3. 「アクティブ 」チェックボックスが選択されていることを確認します。

    ServiceNow アクティブ ユーザー

ステップ 4

ServiceNow の OAuth 2.0 プラグインがアクティブであることを確認します。

  1. ServiceNow で、[ System Definition (システム定義)] > [Plugins (プラグイン )] をクリックします。

  2. [スクリプト - バックグラウンド ] セクションで次のスクリプトを実行します。

    var oauthActive = gs.getProperty('com.snc.platform.security.oauth.is.active');
    gs.info('OAuth Active: ' + oauthActive);

    スクリプトが trueを返す場合、プラグインのインストールは成功しています。このスクリプトが falseを返す場合は、アンインストールしてから再インストールします。

    ServiceNow OAuth 2.0 プラグイン

ステップ 5

OAuth エンドポイントが正しく設定されていることを確認します。

  1. ServiceNow で、 System OAuth > Application Registry にアクセスします。

  2. 右上隅の [ NEW ] をクリックします。

  3. OAuth アプリケーションオプションで、「 外部クライアント用の OAuth API エンドポイントを作成する 」をクリックします。

    ServiceNow は、外部クライアント用の OAuth API エンドポイントを作成します

  4. 「アクティブ 」チェックボックスが選択されていることを確認します。

    ServiceNow の新しい OAuth アプリケーション

    OAuth アプリケーションが正常に作成されると、 そのアプリケーションは [System OAuth (システム OAuth )] > [Application Registry (アプリケーション レジストリ)] のリストに [OAuth クライアント ] タイプで表示されます。

ステップ 6

これらのトラブルシューティング手順を実行しても問題が解決しない場合は、 サポート チケットを提出してください。