Miro用Gleanのセットアップ（管理者ガイド）

対象者: 会社の管理者
プラン: Business, Enterprise
プラットフォーム: デスクトップ, ブラウザ

会社の管理者として、組織向けにGleanのインテグレーションをインストールおよび設定できます。これにより、GleanのAI駆動の検索機能がMiroに直接組み込まれ、チームが100を超えるソースシステムから情報を見つけ、生産性を向上させることができます。

前提条件

1. あなたはMiro 組織管理者およびGlean 管理者です。
2. Glean で、OAuth クライアント ID を登録してください。詳細については、Glean のドキュメントを参照してください。
3. ユーザーレベルのプライバシー設定でチャット履歴を最大 30 日間保存することを許可します。

Glean アプリをインストールする

最初に、Miro マーケットプレイスから組織内の関連するチームに Glean アプリをインストールしてください。

1. 「会社の設定」に移動し、「アプリとインテグレーション」をクリックします。
2. 「アプリ」タブの下で、「アプリを追加」をクリックしてマーケットプレイスを開きます。
3. 「Glean」を検索します。また、クライアントIDを検索バーに貼り付けて見つけることもできます：1202342442818548396。
4. アプリプロフィールから、アプリを追加する場所を選択します：「すべてのチーム」または「特定のチーム...」を選択します。
5. 権限ページを確認します。GleanアプリはMiroによって開発および保守されており、特定の権限を必要としません。
6. 追加を選択してインストールを完了します。

シングルサインオン設定（Okta）

組織がOktaをシングルサインオン（SSO）プロバイダーとして使用している場合、次のセクションに進む前にOkta OpenID Connect（OIDC）Webアプリケーションを作成する必要があります。

1. ドキュメントに記載されている手順に従って、新しいOktaアプリをこちらから作成します。
   1. OIDC - OpenID Connect をログイン方法として選択します。
   2. Web アプリケーション をアプリケーションタイプとして選択します。
   3. 許可タイプ > コア許可 設定でリフレッシュトークンが有効になっていることを確認します。
   4. https://integrations.miro.com/api/external-auth/oauth2/callback をサインインのリダイレクトURIとして追加します。
   5. 保存を選択します。
2. クライアントIDとクライアントシークレットをクライアント認証情報セクションからコピーしてください。これらは次のセクションでインテグレーションセットアップを完了するために必要です。

シングルサインオン（SSO）の設定

アプリを設定するために以下の手順に従ってください：

1. アプリとインテグレーションページから、アプリ管理に移動します。
2. インストール済みアプリのリストから「Glean」を見つけてその設定をクリックします。アプリが表示されない場合は、クライアントID（1202342442818548396）で検索して、まず承認してください。
3. 構成設定で、SSO プロバイダーを選択します。
   1. Okta
   2. Azure
   3. Google
4. 必要な SSO 詳細を入力します。
   1. Okta: Glean ベース URL、Okta アプリの詳細（認証サーバー URL、アクセストークン URL、クライアント ID、クライアント シークレット)。
   2. Azure: Glean ベース URL。
   3. Google: Glean ベース URL。
5. 保存をクリックして設定を適用します。

✏️ Azureをご使用の場合、Microsoft Entra管理センターでMicrosoft Entra管理者がGleanアプリの「組織を代表して同意する」を選択していることを確認してください。これにより、ユーザーは正しく認証できます。

Glean管理者コンソールの設定

MiroでGleanを使用する前に、Glean管理者コンソールでOAuthトークンベースのアクセスを設定する必要があります。

1. Glean 管理者コンソールを開き、設定 > サードパーティアクセス (OAuth)に進みます。
2. IDP-設定済み OAuth セクションで、API アクセスのための IDP OAuth を有効化を選択します。
3. 設定を管理をクリックし、SSO プロバイダーを選択します。
4. SSOプロバイダーに基づいてプロバイダーの詳細を入力します。
   • Okta
     • 認証サーバーURL: https://<yourOktaDomain>/oauth2/v1/authorize
     • 許可されたクライアントID: 前のセクションで作成されたOktaアプリのクライアントID。
     • 他のフォームフィールドは空のままでかまいません。
   • Azure
     • 発行者サブドメイン: https://login.microsoftonline.com/<tenant-id>/v2.0
     • 許可されたクライアント ID: a49fdb25-3b5f-4d3b-bedf-6da7be2b4bf4
   • GSuite
     • 許可されたクライアント ID: 1062019541050-pf2ndc9f3o4lrmkupj3cj0fep5hkecns.apps.googleusercontent.com
5. 設定を適用するには、保存を選択します。

⏰ 注意: Glean管理者コンソールで変更が反映されるまでに最大30分かかる場合があります。

Glean アプリの使用

アプリのインストールと設定が完了すると、指定されたチームのユーザーが使用を開始できます。ユーザーが Miro で初めて Glean アプリを開くと、認証を求められます。

1. Miro ボードを開き、ツールバーの Glean アイコンをクリックしてサイドパネルを開きます。
2. Connect Glean をクリックして認証を開始します。
3. SSO 認証ダイアログが表示されます。
4. 認証に成功すると、Glean のインターフェイスが表示され、使用可能となります。

セキュリティー

データとセキュリティーの詳細については、このセキュリティー文書を参照してください。