認証パターン

アドインでは、ユーザーが機能にアクセスするためにサインインまたはサインアップする必要がある場合があります。 一般的な認証制御には、ユーザー名とパスワードのフィールドと、Microsoft 以外の資格情報フローを開始するボタンが含まれます。 シンプルで効率的な認証エクスペリエンスは、ユーザーが迅速に開始するのに役立ちます。

ベスト プラクティス

するべきこと してはいけないこと
サインインする前に、アドインの値を記述するか、アカウントを必要とせずに機能を示します。 ユーザーがアドインの価値と利点を理解せずにサインインすることを期待します。
各画面に目立つ第 1 のボタンを配置し、ユーザーに認証フローを段階的に説明します。 ボタンや行動喚起が競合する第 2 のタスクや第 3 のタスクに注意を向けさせます。
"サインイン" や "アカウント作成" など、特定のタスクを説明するわかりやすいボタン ラベルを使用します。 "送信" や "開始" などのあいまいなボタン ラベルを使用します。
ダイアログを使用し、ユーザーの注意を認証フォームに向けさせます。 作業ウィンドウを、初回実行時のエクスペリエンスと認証フォームで混雑させます。
自動フォーカス入力ボックスなど、フロー内の小さな効率を見つけます。 ユーザーがフォーム フィールドをクリックするように要求するなどの不要な手順を操作に追加します。
ユーザーがサインアウトして再認証する方法を提供します。 ID を切り替える際、アンインストールをユーザーに強制します。

認証フロー

このフローを使用して、最初の実行エクスペリエンスから完了したサインインまでユーザーをガイドします。

  1. First-run placemat: アドインの初回実行エクスペリエンスで、サインイン ボタンを明確なアクションの呼び出しとして配置します。

    Office アプリケーションのサンプル アドイン作業ウィンドウ。

  2. [ID プロバイダーの選択] ダイアログ: 必要に応じて、ユーザー名とパスワードのフォームなど、ID プロバイダーの明確な一覧を表示します。 認証ダイアログが開いている間、アドイン UI がブロックされる可能性があります。

    Office アプリケーションの [ID プロバイダーの選択肢] ダイアログ。

  3. ID プロバイダーのサインイン: ID プロバイダーには独自の UI があります。 Microsoft Entra IDでは、サインイン ページとアクセス パネル ページのカスタマイズがサポートされ、外観とサービスの一貫性が保たれます。 詳細については、「会社の ブランド化を構成する」を参照してください。

    Office アプリケーションの [ID プロバイダー サインイン] ダイアログ。

  4. 進行状況: 設定と UI の読み込み中の進行状況を示します。

    Office アプリケーションの進行状況インジケーターを含むサンプル ダイアログ。

注:

Microsoft Entra IDを使用する場合は、明るいテーマと暗いテーマに合わせてカスタマイズできるブランドのサインイン ボタンを使用できます。 詳細については、「Microsoft ID プラットフォームと OAuth 2.0 認証コード フロー」を参照してください。

シングル サインオン認証フロー

注:

シングル サインオン API は現在、Word、Excel、Outlook、PowerPointでサポートされています。 シングル サインオンのサポートの詳細については、「 IdentityAPI 要件セット」を参照してください。 Outlook アドインを使用している場合は、Microsoft 365 テナントの先進認証を有効にしてください。 これを行う方法については、「Exchange Onlineで Outlook の先進認証を有効または無効にする」を参照してください。

よりスムーズなエンド ユーザー エクスペリエンスを実現するには、シングル サインオンを使用します。 Office 内のユーザーの ID (Microsoft アカウントまたは Microsoft 365 ID) は、アドインへのサインインに使用されます。 そのため、ユーザーは 1 回だけサインインします。 お客様は途中で止められることなく、簡単に利用を開始できます。

  1. アドインがインストールされると、次のような同意ウィンドウがユーザーに表示されます。

    アドインのインストール時の Office アプリケーションの同意ウィンドウ。

    注:

    アドインの発行元は、同意ウィンドウに含まれるロゴ、文字列、アクセス許可のスコープを制御します。 Microsoft は同意ウィンドウ UI を事前に構成します。

  2. ユーザーが同意すると、アドインが読み込み、ユーザー固有の情報を抽出して表示できます。

    リボンにアドイン ボタンが表示された Office アプリケーション。

関連項目

  • Last updated on