メインコンテンツまでスキップ
に最終更新

ServiceNow

備考

プレビュー

Lakewatchはプライベート プレビュー段階です。アクセスをリクエストするには、Databricksアカウントチームにお問い合わせください。

Lakewatch アラートをServiceNowにエクスポートします。アラートが作成されると、LakewatchはServiceNowにインシデントレコードを作成し、アラートの変更に応じてレコードを更新します。宛先間でのエクスポートの動作については、アラート通知先を参照してください。

ServiceNowへのエクスポートは、LakewatchからServiceNowへの一方向です。Lakewatchは、ServiceNowで登録するOAuthアプリケーションでサインインします。

レコードの作成および更新方法​

  • アラート作成時 ：Lakewatchは、ServiceNowインスタンスにインシデントレコードを作成します。
  • 変更時 ：アラートのタイトル、説明、または状態が変更されると、Lakewatchは同じレコードを更新します。

各レコードの相関IDにはLakewatchアラートIDが含まれているため、レコードからアラートまでさかのぼって追跡できます。

前提条件​

ServiceNowを設定する​

ServiceNowで、Lakewatchがインシデントレコードの作成と更新に使用するOAuthアプリケーションを登録します。これらは大まかなステップです。詳細な手順については、 ServiceNow OAuthドキュメントを参照してください。

  1. ServiceNowで、 System OAuth > Application Registry に移動し、 Create an OAuth API endpoint for external clients を選択します。新しいアプリケーションを作成することも、既存のアプリケーションを再利用することもできます。
  2. クライアントの種類 に サービスとしての統合 を設定し、 スコープ制限 に 広範なスコープ を設定し、 OAuthアプリケーションユーザー を設定します。
  3. OAuthアプリケーションユーザーにincident_managerロールを付与して、インシデントレコードの作成と更新ができるようにします。

インスタンスID、OAuthクライアントID、およびクライアントのシークレットをメモします。

クライアントシークレットをUnity Catalogシークレットとして保存する​

Lakewatch環境 のカタログのスキーマの Unity Catalog シークレット に OAuth クライアントのシークレットを保存します。__lakewatch 「シークレットの選択」 にはそのスキーマのシークレットが一覧表示され、 「シークレットの作成」 ではそのスキーマにシークレットが作成されます。Lakewatchはシークレット名のみを保存し、シークレット値は保存しません。

このシークレットは、事前に <catalog>.__lakewatch で作成しておくか、ServiceNow エクスポートを構成する際に シークレットの作成 ボタンを使用して作成できます。いずれの場合も、シークレットを作成するには、カタログに対する USE CATALOG と、__lakewatch スキーマの所有権、またはそのスキーマに対する CREATE SECRET と USE SCHEMA の両方が必要です。ステップについては、シークレットの作成 を参照してください。

必要なアクセス許可​

ServiceNow エクスポートを構成するには、以下が必要です。

  • READ SECRET クライアントシークレットを保持しているUnity Catalogのシークレット、あるいはその親スキーマまたはカタログ。構成を保存するとき、Lakewatchはシークレットを読み取ることができるかチェックします。それを付与するには、「シークレットに対する権限を管理する」を参照してください。
  • Lakewatch環境のカタログに対するMANAGE権限。設定の構成を参照してください。

クライアントシークレットを変更するには、同じ Unity Catalog シークレットの値を更新します。Lakewatchは次のエクスポートで新しい値を使用し、設定には変更が加えられません。別のシークレットを使用するには、設定で シークレットを選択 または シークレットを作成 をクリックして保存してください。

ServiceNowをアラート通知先として設定する​

アラート 設定セクションで、アラートの ServiceNow 送信先を設定します。

  1. Lakewatchサイドバーで、 設定 に移動し、 アラート を開きます。
  2. 配信 で、 アラート通知先 を ServiceNow に設定します。
  3. インスタンスID に、インスタンスのホスト名の最初の部分のみを入力します。https://acme.service-now.comの場合、acmeを入力します。
  4. クライアントID で、ServiceNowに登録したアプリケーションのOAuthクライアントIDを入力します。
  5. クライアントシークレット の場合は、 シークレットを選択 をクリックしてクライアントシークレットを保持しているシークレットを選択するか、 シークレットを作成 をクリックしてページを離れずにクライアントシークレットからシークレットを作成します。このフィールドにはシークレットの名前が表示されます。値ではありません。
  6. 変更を保存します。

完全なアラート設定リファレンスについては、「 構成設定」を参照してください。

トラブルシューティング​

  • ServiceNowでレコードが作成されない ：OAuthアプリケーションユーザーがインシデントレコードを作成できないか、インスタンスIDが間違っています。アプリケーションユーザーにincident_managerロールが付与されていること、およびインスタンスIDがホスト名の最初の部分のみ（例：acme）であることを確認します。
  • 構成が保存されません ：Unity Catalogのシークレットを読み取る権限がないか、シークレットがLakewatch環境とは異なるカタログにあります。シークレットとそのカタログへのアクセス権を確認してください。
  • シークレットの選択にシークレットが表示されません : シークレットの選択 には、環境のカタログの __lakewatch スキーマでアクセスできるシークレットのみがリストされます。そこにシークレットを格納するか、シークレットに対する READ SECRET を要求してください。
  • 認証が失敗しました ：クライアントIDまたはクライアントシークレットが間違っているか、OAuthアプリケーションに権限がありません。ServiceNowのクライアントID、シークレット値、およびアプリケーションのアクセス権を確認します。
  • クライアント シークレットをローテーションした ：Unity Catalogのシークレットを新しい値で更新します。エクスポート構成を変更する必要はありません。
このページの見出し