管理画面へのログインとメールを整える

パスキー、メールのログイン、外部ログインの違いと、メール送信を実際に確かめる手順を説明します。

目次

管理画面へ入れる状態を、公開先でも確かめる

認証は、操作する人が誰かを確かめる仕組みです。EmDashでは、標準のログインにパスキーを使います。指紋認証、顔認証、端末のロックを解除するPINなどを使って、登録した本人であることを確かめます。

ローカルでログインできたことと、公開ドメインでログインできることは別です。パスキーはサイトのドメインと結び付きます。公開URLを決めたら、そのURLで管理画面を開いて確認します。

会社の認証ルールを必須にしたい場合は会社のログインとSSO、ログイン状態の安全な扱いはCookieとセキュリティヘッダー、退職時の停止は利用者の追加と停止も確認してください。

パスキーでログインする

公開先URLの/_emdash/admin/を開き、未ログインならSign inを選びます。ブラウザーの案内に沿って、登録済みのパスキーを使います。

初回設定では、パスキーをどの端末やパスワード管理アプリへ保存したかを覚えておきましょう。端末だけにあるのか、利用している管理サービスで同期されるのかにより、別の端末での使い方が変わります。

最初の管理者登録でメールアドレスを入力しても、パスキーで初期設定した場合、そのアドレスの受信確認まで済んだとは限りません。

メールでログインするには送信設定が必要

Sign in with emailは、ログイン用リンクをメールで受け取る方法です。入力したアドレスでメールを受け取り、リンク先でContinueを選んでログインします。公式資料ではリンクは1回限りで、有効期限は15分です。

メールでログインするには、サイトのメール送信設定が必要です。設定していない場合、パスキーを失ってもメールでログインし直すことはできません。

開発中のメールは、送信されていない場合がある

astro devでは、ほかの送信方法がない場合にconsole providerが使われます。これはメールを相手に送らず、コマンド入力画面へ内容を表示する開発用の仕組みです。

コマンド入力画面にログインリンクが出ても、受信箱には届いていません。本番では、この開発用の仕組みは動きません。

SMTPで送信する

SMTPは、メールを送るサーバーへ渡すための方式です。利用しているメールサービスから、サーバー名、ポート、ログイン情報、使用できる差出人アドレスを確認します。

  1. 管理画面でSettings → Emailを開きます。
  2. SMTPを選び、サービスから指定された値を入力します。
  3. 暗号化キーが設定されていることを確認して保存します。
  4. Send test emailで、自分が受信できる宛先へ送信します。
  5. 受信箱で差出人、本文、リンク先を確認します。

SMTPのパスワードを管理画面から保存する場合は、EMDASH_ENCRYPTION_KEYが必要です。公式の組み込みSMTPは認証前にTLSによる暗号化を要求し、ポート25を受け付けません。一般に587や465を使いますが、値はサービスの指定に合わせます。

設定を環境変数から渡す方法もあります。ただし管理画面で保存した設定が優先されるため、古いパスワードが残っていないか確認します。Node.jsでは.envを置くだけであらゆる実行時変数が自動的に読まれるわけではないので、秘密値の公式ガイド(別タブで開く)に従います。

別の送信サービスを使う場合

CloudflareのEmail Sendingや、対応する送信プラグインを使う構成もあります。送信元ドメインの準備や、CloudflareのサービスをWorkerから使うための接続設定(binding)など、選んだ方式に必要な設定を行います。

メール送信を担当する仕組みをproviderと呼びます。一度に選べるproviderは一つです。導入しただけで切り替わらない場合は、Settings → Emailで現在選択されているものを確認します。

テストの成功表示に加え、実際の受信、迷惑メールへの振り分け、ログインリンクの公開ドメインも見ます。SPF・DKIM・DMARCなどの送信ドメイン設定は、メールサービス側の案内に従います。

Googleなどのログインを使う場合

GitHub、Google、Microsoftなどを、ログインの本人確認を担当するサービス(provider)として追加できます。サイト側の設定に加え、利用するサービス側でアプリを登録します。ログイン後にサイトへ戻るためのコールバックURLや秘密値も、両方の設定を合わせる必要があります。authProvidersで追加する方式と、Cloudflare Accessを認証の入口にする方式は別です。

特にCloudflare Accessは、本番で保護されたEmDashルートの認証を担当する専用モードです。パスキーに単純にボタンを一つ足す設定と混ぜず、認証の公式資料(別タブで開く)で選ぶ方式を確認します。

確認して残すこと

管理者のログイン、別端末での利用、メール送信、招待を使う場合の受信を確認します。予備のログイン経路を準備し、使えることを試してから日常運用に入ると、端末の買い替え時にも対応しやすくなります。

共有する運用メモには、秘密値そのものではなく、設定の場所、管理者、復旧方法を書きます。

公式の参照元

関連ガイド

メニュー
ホーム公式ドキュメント (別タブで開く)

キーワードを入力すると、ガイドの内容から探せます。