Logto で Outline の認証を簡素化する

はじめに#

• Logto は、必要な機能をすべて備えた手間のかからないアイデンティティ ソリューションです。ユーザー名、メールアドレス、電話番号、Google や GitHub などの一般的なソーシャル サインインを含むさまざまなサインイン方法をサポートしています。
• Outline は、成長するチームのためのナレッジベースとして機能します。

最高なのは、 Logto と Outline の両方がオープンソースであることです。この記事では、 Logto を Outline の OpenID Connect (OIDC) アイデンティティ プロバイダーとして使用する方法を示します。

必要条件#

始める前に、次のものを確認してください:

• 実行中の Logto インスタンスまたは Logto Cloud アカウントへのアクセス。
• 環境変数にアクセスできる Outline ホスティング環境。

Logto の設定#

Logto を自己ホストしている場合、 Logto インスタンスをセットアップするには「スタートガイド」ドキュメントを参照してください。

Logto Cloud を使用している場合は、「 Logto Console」を開くには、 URL https://cloud.logto.io/ を入力するか、自己ホスティング用に設定したエンドポイントを入力します。

次に、「アプリケーション」タブに移動して「アプリケーションを作成」をクリックします。

表示されるモーダルで「従来の Web」を選択し、「Outline」などのアプリケーション名を入力します。その後、「アプリケーションを作成」ボタンをクリックします。

Logto のチュートリアルページに移動します。右上隅にある「スキップ」をクリックしてアプリケーションの詳細ページに進みます。

「リダイレクト URI」セクションで、次の値を入力します:

たとえば、 Outline を http://localhost:3000 でホスティングしている場合、値は次のようになります:

ページの下部にある「変更を保存」ボタンをクリックします。成功したら、このページを開いたままにしておいてください。 Outline の設定に役立ちます。

Outline の設定#

Outline ホスティングガイドに記載されているステップに従って、認証設定のステップに進みます。 Outline はデフォルトで OIDC 対応の認証プロバイダーをサポートしているため、必要な設定値のほとんどは Logto アプリケーションの詳細ページで簡単に見つけることができます。

必要な設定詳細は次の表を参照してください:

追加の変数を含むもう 1 つの表を以下に示します:

セルフホストの場合のみ: Logto でメールサインインを設定#

Outline ではユーザーのメールが提供されている必要があるため、メールサインインまたは Google サインインのような信頼できるメールアドレスを提供するソーシャルサインインを設定する必要があります。

Logto でコネクタを設定する方法については、「コネクタの設定」を参照してください。

チェックポイント: Logto と Outline の統合をテスト#

Outline インスタンスを起動し、そのエンドポイントにアクセスします。「OpenID Connect で続行」とラベル付けされたボタンが中央に表示されるはずです。これは OIDC_DISPLAY_NAME 環境変数を設定してカスタマイズできます。

ボタンをクリックすると、 Logto のサインインエクスペリエンスにリダイレクトされます。

すべてが正しく設定されている場合は、 Logto でサインインまたは登録を完了すると、 Outline にリダイレクトされます。ページの左下に個人情報が表示されます。

統合中に問題が発生した場合は、 [email protected] 掛けてメールでお気軽にお問い合わせいただくか、Discord サーバーに参加 してください!

関連書籍#

• サインインエクスペリエンスのカスタマイズ
• コネクタの設定
• API を保護する