認証

[管理] ページの [OAuth クライアント] オプションに移動します。

新しい [OAuth クライアント] ページが開いたら、[+OAuth クライアント] ボタンをクリックします。

新しい OAuth クライアントを作成するには、新しいモーダルで次のプロパティを指定する必要があります。

• Name
• クライアント ID
• クライアント シークレット
• リダイレクト URL

すべてのプロパティを入力したら、[作成] をクリックします。

クリックすると、新しい OAuth クライアントが、[OAuth クライアント] リストに表示されます。

この OAuth クライアントまたは既存の OAuth クライアントは、編集ボタン を使用して編集できます。

[クイック編集] と呼ばれる新しいモーダルが開きます。ここでは、プロパティを編集できます。

必要な編集が終了したら、[保存] をクリックします。

不要になった OAuth クライアントは、削除アイコン をクリックして削除できます。

[OK] をクリックして削除を確認します。

ClientId と ClientSecret に加えて、プロジェクトから Sitecore Content Hub で認証するために、ユーザー名とパスワードを指定する必要があります。これらの値は、IWebMClient インスタンスを構築するために必要です。

以下に、Sitecore Content Hub 認証の例を示します。

using System;
using Stylelabs.M.Sdk.WebClient;
using Stylelabs.M.Sdk.WebClient.Authentication;

namespace Stylelabs.M.WebSdk.Examples
{
public class Program
{
static void Main(string[] args)
{
// Your Sitecore Content Hub endpoint to connect to
Uri endpoint = new Uri("https://your.m.endpoint.com");

// Enter your credentials here
OAuthPasswordGrant oauth = new OAuthPasswordGrant
{
ClientId = "client_id",
ClientSecret = "client_secret",
UserName = "username",
Password = "password"            
};

// Create the Web SDK client
IWebMClient MClient = MClientFactory.CreateMClient(endpoint, oauth);
}
}
}

username と password による認証の代わりに、リフレッシュ トークン認証を使用できます。「リフレッシュ トークン認証」では、IWebMClient.RefreshTokenReceived イベントをサブスクライブすることが重要です。OAuthPasswordGrant を作成するのではなく、この部分を OAuthRefreshTokenGrant に変更します。

// Enter your credentials here
OAuthRefreshTokenGrant oauth = new OAuthRefreshTokenGrant
{
ClientId = "client_id",
ClientSecret = "client_secret",
RefreshToken = "SFGDXCbHujaXXMo_Yv2Rf5VUXR2M5GFQBCf4GnxqXIEU9wC0U4M44qHBQ8QO5I-XMlzwb2oUBue_sPsuohUqrGchf_Pfx3jRw7J2xHlxTSRZFRtVLXGQvxE_ZUyj3zIzcM56Lz8NYBzveEd7UjSEBn47RcHnbUC96u30MFrXpHphOmwAfnyENnXgaNmT6Dz1H7_YbuGF_kCGZsFXoT-Fm1NKYoZLn3N4zbB0v-I3Aof16c0_q_FsfVfnOLoviGDKwsrFAHPPLfY6PCj8dSE4vA"
};

リフレッシュ トークンが変更されると、古いトークンは無効になります。常に最新のリフレッシュ トークンを追跡するようにしてください。

認証クライアントを作成したら、TestConnectionAsync を呼び出して構成をテストすることができます。これにより、失敗の原因を説明する例外がスローされます (例外がある場合)。

await MClient.TestConnectionAsync();

このメソッドは、次の要素をチェックします。

• サーバーが実行されているかどうか
• クライアントがサーバーに正常に接続できるかどうか
• SDK とサーバーにバージョンの互換性があるかどうか
• 資格情報が正しいかどうか

MClient.TestConnectionAsync().Wait();

static async Task Main(string[] args)