はじめに
お疲れ様です。矢儀 @yuki_ink です。
GitHub Enterprise Cloudのトライアル環境を払い出そうとしていたところ、初回ログインのために必要なパスワード設定メールが届かないという事象に遭遇しました。
トライアル環境払い出しの流れは、ざっくりこんな感じ。
1. トライアルを申し込み、Enterprise環境が払い出される
2. 案内メールから、初期設定用の「セットアップユーザー」のパスワードを設定する
3. セットアップユーザーでログインする
4. Oktaとの認証連携と、ユーザーを作成・管理するためのプロビジョニングを設定する
5. Oktaから作成したユーザーでログインし、利用を開始する
2のメールが届かねえ・・・
こちらの記事を参考にさせていただきましたが、「Set your password」のメールが1日待っても届かない。
Welcomeメールは届いていたものの、パスワード設定メールが届きませんでした。
そのため、セットアップユーザーでログインできず、Oktaとの連携などの設定にも進めない状態でした。
【前提】
今回入力した情報は以下の通り
・Enterprise Managed Users(EMU)を利用 ※Oktaとの連携を想定
・データレジデンシー指定あり(Japan)
・メールアドレスとしては、複数の担当者が含まれたメーリングリストを指定
本記事では、この初回ログインの仕組みと、メールが届かないときに確認したこと、解決までの対応を備忘として残しておきます。
初期設定に使う「セットアップユーザー」とは
Enterprise Managed Users(EMU)は、IdPを使ってGitHubのユーザーを管理する仕組みです。
ただ、環境を作成した直後は、そのIdPとの連携自体がまだ設定されていません。
そこで、通常の利用者とは別の「セットアップユーザー」を使って初期設定を行います。
GitHubの公式ドキュメントでは、Enterpriseの作成後に、セットアップユーザーのパスワードを設定するためのメールが届くと説明されています。
このユーザーでログインし、認証とプロビジョニングを設定する流れです。
Enterprise を作成すると、セットアップ ユーザーのパスワード (認証とプロビジョニングの構成に使用される) を選択するように求めるメールが届きます。 これは最初のエンタープライズ所有者アカウントであり、SCIM プロビジョニングされていないエンタープライズ内の唯一のユーザー アカウントです。 ユーザー名は、エンタープライズのショートコード (ユーザーが選択するかランダムに生成される) にサフィックス _admin が付いたものです。 たとえば、 fabrikam_adminと指定します。
パスワード設定メールが届かんくても、ログイン画面の「パスワードをリセット」からリセットすればいいのでは?
→ダメそう!!😇
セットアップ ユーザーのパスワードをリセットする必要がある場合、GitHub Support ポータル から GitHub のサポート に問い合わせます。 メール アドレスを指定した通常のパスワードのリセット オプションは機能しません。
(出典)ユーザーのセットアップ
パスワード設定メールが迷惑メールとしてフィルタされていないか、3回くらい確認しましたが、やっぱりメールが届いているように見えない・・・
しょうがないのでサポートを頼りました。
サポートに頼んだこと
サポートケースを起票して、まずはシンプルに、パスワード設定メールの再送をお願いしました。
→これも届きませんでした😇
次に、違うメールアドレス(メーリングリストではなく、個人のメアド)に再送をお願いしました。
→これはちゃんと届きました!!解決!!
今回はサポートが対応してくれた事例であり、どの環境でも同じ対応を受けられると保証するものではありません。
詳細を確認すると、サポート側で、トライアル環境に紐づくメアドをメーリングリストから個人アドレスに更新して、その上でセットアップユーザーのパスワードリセットの手続きを進めていただいたようです。
パスワード設定後、トライアル環境のメアドの設定をメーリングリストに戻して対応完了!
終わりに
今回は、GitHub Enterprise CloudのEMUトライアル環境で、初回ログインに必要なパスワード設定メールが届かなかった事象を紹介しました。
Welcomeメールは来ているのに、パスワード設定メールを受信できることはできてない・・・
という謎事象に再現性があるのか分かりません😅
根本原因がわからず気持ち悪いですが、環境準備を前に進めるための案として、もし同じところで止まってしまった方がいらっしゃった時に、参考になれば幸いです。