---
title: "ウォークスルー:認可アイテムの使用"
slug: "walkthrough--using-an-authorization-item"
abstract: "認可アイテムの作成、設定、使用方法を説明します。"
---
# ウォークスルー:認可アイテムの使用

ウェブフックの宛先エンドポイントに認証が必要な場合は、まず認証項目を作成・設定し、それをウェブフックに割り当てる必要があります。コンテンツエディターで認可アイテムを作成できます。

[SitecoreAIは](https://doc.sitecore.com/sai/en/users/sitecoreai/sitecoreai.html) 複数の認証タイプをサポートしています。認証タイプやフィールド定義の詳細については、[Webhook認証タイプ](https://doc.sitecore.com/sai/ja/developers/sitecoreai/content-modeling-and-presentation/workflow/webhooks/walkthrough--using-an-authorization-item/webhook-authentication-types.html "Webhook authentication types")を参照してください。

このウォークスルーでは、以下の方法を説明します:

-   承認アイテムを作成します。
-   認証アイテムを設定してください。
-   ウェブフックに認可アイテムを追加します。

## 承認項目を作成する

認可項目を作成するには:

1.  コンテンツツリーで */sitecore/System/Settings/Webhooks/Authorizations* フォルダに移動します。
2.  コンテンツエリアの **フォルダ** タブの **オプション** セクションで、作成したい認可アイテムの種類をクリックしてください。
3.  **メッセージ**ダイアログで、承認項目の名前を入力してから**OK**をクリックします。

## 認可項目の設定

認可項目の設定は、認可 [項目のフィールド](https://doc.sitecore.com/sai/ja/developers/sitecoreai/content-modeling-and-presentation/workflow/webhooks/walkthrough--using-an-authorization-item/webhook-authentication-types.html "Webhook authentication types")に必要な認証データを入力することで可能です。

認可項目を設定するには:

1.  コンテンツツリーで */sitecore/System/Settings/Webhooks/Authorizations* フォルダに移動し、設定したい認可項目をクリックします。
2.  コンテンツ欄で「 **データ** 」セクションをクリックすると、承認項目のフィールドが表示されます。
3.  該当するフィールドを設定し、**保存をクリックします。**

### 認証フィールドを正しく設定してください

認可項目の必要フィールドは、ウェブフックの [認証タイプ](https://doc.sitecore.com/sai/ja/developers/sitecoreai/content-modeling-and-presentation/workflow/webhooks/walkthrough--using-an-authorization-item/webhook-authentication-types.html)によって異なります。正しい値は識別提供者によって異なります。

以下は、OAuth2.0 Client Credentials Grant, Azure ADの例です:

Authority URL:
https://login.microsoftonline.com/<tenant-id>/v2.0
Client ID:
<your-client-id>
Client Secret:
<your-client-secret>
Scope:
https://graph.microsoft.com/.default
Header Prefix:
Bearer
Additional Endpoint Base Addresses:
https://login.microsoftonline.com/<tenant-id>;https://graph.microsoft.com/oidc/userinfo

> !注  
>   
> よくある問題:
> 
> -   Authority URLの代わりにトークンエンドポイントを使うこと。  
>     サンプル正解値: https://login.microsoftonline.com/<tenant-id>/v2.0
> -   Microsoftプロバイダーの追加エンドポイントベースアドレスが欠けている

## ウェブフックに認可アイテムを追加します

ウェブフックに認可アイテムを追加するには:

1.  コンテンツツリーで、認証を追加したいウェブフックをクリックします。
2.  コンテンツエリアの **「データ** 」セクションの **「認可」** ドロップダウンメニューで、ウェブフックに追加したい承認項目をクリックします。
3.  **「保存**」をクリックします。