サインインブリーフィングを予約

第 2.12 章

初回起動

未申請のインストール環境から業務の開始まで。申請コードを作成し、ブラウザーでインストール環境を申請し、パスキーを使用して最初の管理者を作成してから、会社のサインインを接続して他の全員を招待します。

このページは英語の原文から AI によって翻訳されました。不明な点がある場合は、英語のページを正としてご参照ください。 このページを英語で読む

読了時間 18 分

インストールが完了した時点では、そのインストール環境は誰のものでもありません。組織もユーザーもセッションも存在せず、誰もサインインできません。作成されたばかりのインストール環境と通信していることを、誰か1人がブラウザー上で証明するのを待っている状態です。Harrow Port Authorityでは、その人物はIT責任者のAoife Brennanであり、傍らのターミナルにはTomás Reillyが控えていました。この章では、彼らの最初の20分間を追います。

順序は固定されており、各ステップを完了すると、その前のステップは永久に閉じられます。インストール環境のクレーム(所有権の取得)、最初の管理者と組織の作成、パスキーの設定を経て、Todayページに到達します。その後は、都合の良い順序で、6つの準備項目、社内サインイン、そして他のメンバーの招待を行います。

左から右へ連なるボックスの連鎖:「nexusctl claim-code(ターミナル)」、「このインストールをクレームする(ブラウザ:コード + フィンガープリント)」、「最初の管理者と組織」、「パスキー(2回目の確認)」、「すべてが新しい、今日」、「誰かがサインインする前の6つの項目」、「ユーザーを招待する」。クレームのボックスの下には、2つの赤い分岐が伸びています:「コードが古すぎる:CLAIM_CODE_EXPIRED、新しいコードを作成」および「フィンガープリントが異なる:CLAIM_FINGERPRINT_MISMATCH、停止」。最初の3つのボックスの下にある細い線には、「各ステップは前のステップを永続的にオフにする」というラベルが付いています。
ターミナルから最初のTodayページまでの初回実行の流れと、停止する可能性がある2つの箇所。

申請コードの作成

クレームコードは、ブラウザーの前にいる人物が、クラスターへのアクセス権を持つ人物のターミナルも確認できることを証明するものです。そのような人物だけがコードを作成できます。kubeconfigがクラスターに到達できる環境で、以下を実行してください。

nexusctl claim-code --administrator aoife.brennan@harrow.example

nexusctl claim-codeは、インストール環境のキーサービスであるnexus-keysにコードの作成を要求します。nexusctlがない場合、同じコマンドがキーサービス自身のPod内で実行されます。

kubectl -n nexus exec deploy/nexus-keys -- nexus-keys claim-code \
  --administrator aoife.brennan@harrow.example --source "Tomás Reilly, ops terminal"

--sourceは、誰がコードを作成したかを示す短い言葉です。クレームページの「Made by(作成者)」の下に表示されるため、クレームを行う人物はコードの出所を知ることができます。

 Code  7KQM-4TXD-PL9R  works once, for 30 minutes, until 09:55 · 5 tries
 Fingerprint of this installation, to compare in the browser:
 3F9A C21B 77E0 5D4C 9B12 A6F3 0E88 41D7

コードに関しては、3つの重要な点があります。

  • 有効期限は30分です。肩越しに盗み見られたコードは、すぐに使えなくなります。
  • 試行回数は5回までです。5回間違えると、残り時間にかかわらず使用できなくなります。
  • 1人専用です。ここで指定するメールアドレスは、最初の管理者のものになります。これはクレーム情報とともに引き継がれ、最初の管理者のフォームには固定値として表示され、再入力は不要です。

フィンガープリントは4文字ずつ8つのグループで構成され、インストール環境固有のIDとなります。画面に表示したままにしておいてください。後でブラウザーの画面と、グループごとに比較します。

インストール環境の申請

  1. 最初の管理者として使用するコンピューターで、コンソールのインストール用アドレス(ここではhttps://console.harrow.example/install)を開きます。インストール環境の状態に応じた適切なページに転送されます。未クレームの間はクレームページ、クレーム済みの場合は最初の管理者のページ、すでにサインインしている場合はコンソールが開きます。
  2. Claim this installation(このインストール環境をクレームする)で、Group one、Group two、Group threeに4文字ずつ1グループとしてコードを入力します。
  3. ページのFingerprint of this installation(このインストール環境のフィンガープリント)とターミナルの表示を、8つのグループすべてについて1つずつ比較します。
  4. すべてのグループが一致したら、All eight groups match what my terminal shows(8つのグループすべてがターミナルの表示と一致します)にチェックを入れます。
  5. Claim this installationを押すと、ページでクレームが確認され、最初の管理者の設定へと進みます。
このインストール環境をクレームする
このインストール環境をクレームする
クレームページ。コードは3つのグループに分けて入力し、ターミナルと比較するための完全なフィンガープリントが4文字×8グループで表示されます。右側のカードには、コードの作成元と残りの試行回数が表示されます。

クレームを行うと、3つのことが起きます。このブラウザーが、最初の管理者を作成できる唯一の場所になります。誰がいつインストール環境をクレームしたかが監査ログに記録されます。そして、クレームページが永久に無効化されます。これ以降、クレーム用アドレスにアクセスすると、インストール環境はすでにクレーム済みであるという応答が返されます。

フィンガープリントが一致しない場合は中止してください

フィンガープリントが異なるということは、このアドレスで別のインストール環境が応答していることを意味します。アドレスの入力ミス、古いDNS(Domain Name System)レコード、あるいは最初の管理者を乗っ取るために仕掛けられたマシンの可能性があります。もしクレームしてしまうと、そのマシンがあなたの組織を保持することになります。

クレームを行わず、そのページにコードを入力しないでください。ページを閉じ、2つのことを確認してください。console.harrow.exampleが意図したIngressに名前解決されていること、そしてブラウザーが表示する証明書が想定しているCA(認証局)によって発行されていることです。あなた自身のインストール環境は変更されておらず、まだクレームされていない状態です。

インストール環境のものではないフィンガープリントでクレームが送信された場合、キーサービスはCLAIM_FINGERPRINT_MISMATCH(403)でそれを拒否します。何もクレームされません。ページには2つのフィンガープリントが並べて表示され、異なるグループがマークされるとともに、アドレスと証明書を確認する手順が示されます。

フィンガープリントが一致しません
フィンガープリントが一致しません
フィンガープリントが一致しない場合に遷移するページ。異なるグループがマークされ、他の何かを入力する前にアドレスと証明書を確認する手順が示されます。

最初の管理者と組織の作成

続くページには「Two short forms, then you are in(2つの短いフォームで完了です)」という見出しがついています。最初の管理者は他のすべてのユーザーを追加でき、ここで設定する内容のほとんどは後から変更可能です。ただし2つだけ変更できないものがあり、ページ上で明示されています。

フィールド 入力項目 後から変更可能か
Full name(氏名) あなたの名前 はい
Work email(業務用メールアドレス) クレームコード作成時に指定されたアドレス(表示のみで再入力はしません) 管理者のアドレスとなります
Role in Nexus(Nexusでのロール) 組織の管理者。最初のユーザーは常に管理者になります。 ここでは選択できません
Second check(第2確認要素) このノートPC上のパスキー はい、後から追加可能です
Name(組織名) Harrow Port Authority はい
Country(国) 組織の所在地 はい
Short name in addresses(アドレス内の短縮名) 組織名から生成されます(例:harrow-port-authority) いいえ。リンクやエクスポートで使用されます。
Where data is kept(データの保存場所) このインストール環境 いいえ。後から変更するには新しいインストール環境が必要です。
Language and dates(言語と日付形式) 英語(英国)、今日の日付を例示 はい
Time zone(タイムゾーン) サーバーのタイムゾーン 各ユーザーには自身のタイムゾーンで時刻が表示されます

短縮名は、組織名からアクセント記号を取り除いて作られる、最大100文字の英小文字、数字、ハイフンです。ボタンを押す前によく確認してください。組織が存在する限り、ユーザーが共有するすべてのリンクや作成するすべてのエクスポートにこの名前が表示されます。

このページではパスワードも設定します。ただし、それ単体では決して十分ではありません。管理者がパスワードだけでサインインすることは決してないためです。以下にある第2確認要素が、サインインを完了させます。

同時に、緊急用の管理者サインイン情報も作成されます。これは金庫に保管するため、封印された状態で1度だけ印刷されます。社内サインインが停止している場合にのみ機能し、使用するたびに記録され、すべての管理者に通知されます。印刷したその日のうちに金庫に入れてください。

また、このページには、あなたが誰であるかがAdverantに通知されることはないとも記載されています。これらの詳細情報はインストール環境内に留まります。ライセンスには企業名が記載されますが、社内の個人名が記載されることは決してありません。

Create and sign in(作成してサインイン)を押します。管理者と組織の作成には数秒かかります。ページは「Made for aoife.brennan@harrow.example. Now set up your passkey: it is how you sign in.(aoife.brennan@harrow.example用に作成されました。次にパスキーを設定してください。これがサインインの方法になります)」と応答します。

最初の管理者
最初の管理者
1つのページにまとめられた最初の管理者と組織の設定。決して変更できない2つの選択項目(短縮名とデータの保存場所)にはフィールドの横にその旨が記載され、緊急用サインイン情報は金庫保管用に封印されています。

パスキー:2つ目の確認

  1. Set up the passkey and sign in(パスキーを設定してサインイン)を押します。
  2. ブラウザーがパスキーの作成を求めます。Touch IDまたはWindows Helloを搭載したノートPCでは、指紋、顔、またはPINで確認します。コンピューター自体でパスキーを作成できない場合、ブラウザーはQR(クイックレスポンス)コードを表示します。スマートフォンのカメラをそれに向け、スマートフォンの指示に従ってください。
  3. ページは「Your passkey is set up and you are signed in as aoife.brennan@harrow.example.(パスキーが設定され、aoife.brennan@harrow.exampleとしてサインインしました)」と応答し、コンソールを開きます。

Create and sign inを押してから10分以内に、同じブラウザーでパスキーを作成する必要があります。それを過ぎるとセットアップは閉じられ、管理者はパスキーがない状態で存在することになります。その場合は、以下の再試行の項目で説明するように、オペレーターの支援が必要になります。

これ以降、最初の管理者はそのパスキーを使ってサインインします。完全な権限を持つ管理者のパスワードを単独で入力しても、セッションは決して作成されません。サインインサービスは第2確認要素の要求を返します。これは設計上の特性であり、パスキーが重要である理由です。パスキーを紛失すると入る手段を失うため、初日のうちにスマートフォンやセキュリティキーに2つ目のパスキーを追加しておいてください。

その後、ユーザーは組織が許可する方法(パスキー、Google、GitHub、または社内サインインのいずれか)でインストール環境にサインインします。

コード 意味 対処法
PASSKEY_UNSUPPORTED このブラウザーはパスキーを作成できません。何も設定されませんでした。 同じコンピューター上で、パスキーをサポートするブラウザーでページを開いてください。
PASSKEY_CANCELLED プロンプトが閉じられたか、時間内に何も選択されませんでした。何も送信されませんでした。 もう一度ボタンを押してください。

最初の Today ページ

コンソールはTodayページを開きますが、初日はそのほとんどが空の状態です。各空きエリアには、そこに何が表示されるかと、それを開始するためのボタンが示されます。たとえば「Needs an administrator(管理者の対応が必要)」には、ユーザーが参加し始めるとここにリクエストが待機する旨が書かれており、その横にInvite people(ユーザーを招待)ボタンがあります。セットアップのチェックリストには、順序を問わず、完了したステップの数が表示されます。唯一の実際の履歴であるセットアップ自体は、すでに「What changed(変更履歴)」の下に「インストール環境のセットアップ完了」および「最初の管理者のパスキー作成完了」として記録されています。

すべてが新しい状態の「今日(Today)」
すべてが新しい状態の「今日(Today)」
初日のTodayページ。すべての空きエリアにはそこに何が表示され、どうやって開始するかが示されており、「What changed」にはすでにセットアップ自体の履歴が保持されています。

誰かがサインインする前の6つの項目

Six things before anyone signs in(誰かがサインインする前の6つの項目)ページには、ユーザーを招待する前に満たしておくべき条件が一覧表示されます。これはウィザードではありません。どの順序で行ってもよく、ページには完了した数がカウントされます(「Three of six true(6つ中3つ完了)」など)。

項目 完了の条件
Licence(ライセンス) Enterpriseライセンスがインポートされていること。第2.13章「ライセンス」を参照。Communityではライセンスは不要です。
Address and certificate(アドレスと証明書) 公開アドレスが、チェーンが完全な証明書で応答すること。
Backups(バックアップ) 書き込み可能なターゲットに対して、バックアップスケジュールが設定されていること。
Company sign-in(社内サインイン) 接続およびテストが完了していること。それまでは、ユーザーはパスキーを使用します。
Mail(メール) メールサーバーが設定されていること。それまでは、招待を送信できません。
AI model(AIモデル) AI(人工知能)モデル(組織のモデルキー、または自社ハードウェア上のモデル)が設定されていること。それまでは、アシスタントは待機状態になります。第2.14章「AIプロバイダーとモデル」を参照。

6つすべてが完了すると、Invite peopleが利用可能になります。

同じページには、ユーザーがサインインした後に固定される項目とその理由も一覧表示されます。アドレス内の短縮名、データの保存場所、そしてキーカストディアン(キーはソフトウェアカストディアンからハードウェアへ移行できますが、逆は不可能です)です。組織名も変更可能ではありますが、確認しておく価値があるためあわせて記載されています。

組織にモデルが設定されるまで、Nexusは誰のAIリクエストにも応答しません。インストール環境の背後に共有キーやフォールバックは存在しないため、モデルキーを持たない組織では、管理者に何を追加すべきかを伝える明確な拒否メッセージが返されます。

誰かがサインインする前の6つの項目
誰かがサインインする前の6つの項目
順序を問わない6つの確認項目が、言葉でカウントされます。ユーザーがサインインすると固定される選択項目が理由とともに一覧表示されるため、後から気づいて困ることがありません。

会社のサインイン

ほとんどの組織は、ユーザーがすでに持っているアカウントでサインインすることを望みます。社内サインインページでIDプロバイダーを接続してください。CommunityではOIDC(OpenID Connect)経由、EnterpriseではOIDCまたはSAML(Security Assertion Markup Language)経由で接続できます。

  1. プロバイダーと、それが使用する標準規格を選択します。
  2. IDプロバイダーから提供されたアプリケーションIDとアプリケーションシークレットを入力します。シークレットは保存後、二度と表示されません。
  3. 誰にサインインを許可するか(たとえば、@harrow.exampleのアドレスを持つすべての人など)を指定します。
  4. Test sign-in(サインインのテスト)を押し、自分自身としてサインインします。結果には、誰がサインインし、プロバイダーが何を送信したかが言葉で表示されます。
  5. 保存します。

Communityでは、組織に対して1つの社内サインインを利用できます。Enterpriseでは、強制適用(Enforcement)とディレクトリ同期が追加されます。強制適用を有効にするとパスワードが無効化されるため、全員が社内サインインを使用しなければならなくなり、パスワードでの試行はSSO_REQUIREDで拒否され、正しいサインイン方法へのボタンが表示されます。ディレクトリ同期は15分ごとにディレクトリからユーザーとグループをコピーし、指定した1つのグループから管理者を作成することができます。

社内サインインが応答しなくなった場合、すでにサインインしているユーザーはサインイン状態を維持しますが、新しいサインインはIDP_UNREACHABLE(503)で拒否されます。その際、管理者は金庫から取り出した緊急用の管理者サインイン情報を、自身のパスキーと組み合わせて使用できます。すべての使用は監査ログに書き込まれ、すべての管理者に通知され、4時間後または社内サインインが復旧した時点で終了します。

IDプロバイダーの接続
IDプロバイダーの接続
テスト機能付きの社内サインイン設定。プロバイダー、小さく表示された標準規格、そして実際に運用を始める前に結果が言葉で表示されるテストサインイン。

メンバーの招待

メールの設定が完了したら、People(ユーザー)ページからユーザーを招待します。各ユーザーについて、メールアドレスとロールを指定します。

  • Member(メンバー)は、組織が持つすべての機能を使用しますが、設定の変更は行いません。
  • Administrator(管理者)は、ユーザー、モデル、予算、および設定の管理も行います。

招待の有効期限は7日間です。招待された人がリンクを開くと、誰が招待したか、自分のロール、何が表示されるかを確認してサインインできます。初回のサインイン時には第2確認要素が求められます。

招待されたメンバーはコンソールにサインインし、ロールで許可されている範囲で、Today、アシスタント、チームチャット、ファイルと検索、ノートブック、エージェント、ワークフローなどの日常業務をそこで行います。管理者には管理ページも表示されます。メンバーが管理者のページを開くと、「Not an administrator(管理者ではありません)」というページが表示されます。そこには設定が読み取り専用で表示され、その理由が説明されており、管理者に依頼するためのオプションが提示されます。

同僚を招待
同僚を招待
招待の段階で、参加する前にその人のロール(MemberまたはAdministrator)を選択し、短いメモを添えることができます。

サインアップには承認が必要

ユーザー自身がサインアップして参加を求めることもできます。インストール環境では、見知らぬ人のサインアップによって有効なアカウントが作成されることはありません。nexus-authはSIGNUP_REQUIRES_APPROVAL(403)でそれを拒否し、管理者の承認待ちとして保留します。

Adverantのホスト型サービスには他にも2つのサインアップ制御が存在しますが、すべてのインストール環境ではオフになっており、オンにするための設定値もありません。インターネットCAPTCHAはサインアップのたびにインターネット接続を必要とします。サインアップのネットワークスクリーニングは、インストール環境が持たないライセンス付きのジオロケーションデータベースを必要とします。承認こそが、インストール環境のゲートとなります。

再試行、期限切れのコード、およびその他の拒否

初回実行時のすべての拒否応答では、何が起きたか、何も変更されていない場合はその旨、そして次に何をすべきかが示されます。

コード ステータス 発生条件 対処法
CLAIM_CODE_EXPIRED 410 30分が経過した。何もクレームされておらず、何も変更されていません。 nexusctl claim-code --administrator <email>で新しいコードを作成し、I have a new code(新しいコードを持っています)を押してください。
CLAIM_FINGERPRINT_MISMATCH 403 送信されたフィンガープリントが、このインストール環境のものではない。 中止してください。アドレスと証明書を確認してください。
TRANSITION_NOT_PERMITTED 409 すでに完了したステップが再度要求された(クレーム済みのインストール環境でのクレーム、または2回目の最初の管理者の作成)。 コンソールでサインインしてください。最初の管理者が他のすべてのユーザーを追加します。
TRANSITION_NOT_PERMITTED 409 最初の管理者が待機していないブラウザーからのパスキーステップ、または10分経過後のパスキーステップ。 以下を参照してください。
RATE_LIMITED 429 初回実行ページでの1分間あたりの試行回数が多すぎる。何も送信されませんでした。 ページに示された秒数だけ待ってから、再試行してください。

試行回数が残っていないコードは「This code has no tries left(このコードの試行回数は残っていません)」と表示されます。期限切れのコードと同様に、新しいコードを作成してください。クラスターへのアクセス権を持つ人物だけが作成できるという点が重要です。

初回実行ページ全体で、1分間に20回までの試行を受け付けます。もし自分でそれらの試行を行っていない場合、ネットワーク上の他の誰かがそのページを試行していることになり、それは把握しておくべき重要な事実です。

パスキーのステップを逃した場合

最初の管理者が作成されたものの、10分以内にパスキーが作成されなかった場合、またはブラウザーが閉じられた場合、管理者はサインインする手段がない状態で存在することになります。パスキーのステップはTRANSITION_NOT_PERMITTEDとともに、「If you made the first administrator in this browser over ten minutes ago, ask an operator: the administrator exists and has no passkey yet(このブラウザーで10分以上前に最初の管理者を作成した場合は、オペレーターに依頼してください。管理者は存在しますが、まだパスキーがありません)」というメッセージを返します。この時点でクレームは消費されているため、新しいクレームコードは役に立ちません。他のことを試す前に、インストールを実行したオペレーターに依頼してください。

ブラウザーがクレーム情報を失った場合

クレーム情報は、それを行ったブラウザー内の、ページからは読み取れないCookieに保持されます。クレームから最初の管理者の作成までの間にブラウザーがその情報を失った場合(たとえばプライベートウィンドウを閉じてしまった場合など)、最初の管理者のフォームでは、クレームファイルとそのセットアップシークレットを手動で貼り付けることも受け付けます。

Aoifeがパスキーを取得すると、Tomásはターミナルを閉じました。クレームページは無効化され、最初の管理者が存在し、以降のあらゆるアクセス経路は彼女を通ることになりました。