バージョン 1.0.0-alpha.1最新
第 2.16 章
セキュリティとネットワーキング
インストール環境が許可するインバウンドとアウトバウンドの通信、サービス間で互いの身元を証明する方法、およびオペレーターがサインインとデータベースに対して設定または継承する制御について説明します。
このページは英語の原文から AI によって翻訳されました。不明な点がある場合は、英語のページを正としてご参照ください。 このページを英語で読む

Harrow Port AuthorityのセキュリティレビューがTomás Reillyに最初に投げかけた質問は1つ、「クラスターから外に出るものは何か?」というものでした。彼の回答は1ページに収まりました。nexus名前空間内のものは、ドメインネームシステム(DNS)のルックアップ、少数のワークロード向けのKubernetesアプリケーション・プログラミング・インターフェース(API)、そしてHarrowがvaluesファイルに列挙したアドレス範囲を除き、外部の何にも到達しません。テレメトリーもコールホームもありません。レビューはその後、サインインとデータベースへと移りましたが、この章もほぼその順序に沿って進みます。
ネットワークポリシー
ネットワークポリシーはデフォルトで有効になっており(networkPolicy.enabled: true)、チャートはすべて拒否(deny-all)のポリシーから開始して、Nexusが必要とするものだけを追加します。
| ポリシー | 許可される操作 |
|---|---|
nexus-default-deny |
何も許可しません。名前空間内のすべてのPodを双方向で選択します。 |
nexus-in-namespace |
NexusのPod間の通信、およびポート53でのkube-system内のkube-dnsへのDNSルックアップ。 |
nexus-token-review |
トークンレビュアー(nexus-probitasとnexus-orchestrator)および鍵保管(key-custody)Jobによる、ポート6443または443でのKubernetes APIサーバーへの到達。他のどのPodにもAPIトークンはマウントされません。 |
nexus-ingress-controller |
イングレスコントローラーの名前空間から3つの公開サービスへの到達のみ(それ以外は不可)。 |
nexus-operator-egress |
networkPolicy.externalEgressCIDRs内のアドレス範囲へのPodの到達。このリストが空でない場合にのみレンダリングされます。 |
2台のOpenBaoサーバーは独自のポリシーの背後に置かれています。これらはNexusの一部としてではなくキーストアの一部としてラベル付けされているため、名前空間内のルールはこれらには適用されません。nexus-keysとそのJob(保管Jobを含む)だけがこれらと通信でき、アンシーラーと通信できるのはキーストアだけです。
3つの値がポリシーを形作ります。
# harrow-values.yaml (Helm values): network policy
networkPolicy:
enabled: true
ingressNamespace: ingress-nginx
apiServerCIDRs:
- 10.40.0.10/32
externalEgressCIDRs:
- 10.40.30.25/32
- 10.40.20.0/24ingressNamespaceは、3つの公開ホストの前段にあるイングレスコントローラーの名前空間です。デフォルトのkube-systemは、そこにTraefikを同梱しているk3sに適しています。Harrowは独自のコントローラーをingress-nginxで実行しています。
apiServerCIDRsは、/32のクラスレスドメイン間ルーティング(CIDR)範囲として表されたKubernetes APIサーバーのアドレスです。空のままにすると、チャートはインストール時にkubernetesのEndpointsからそれらを読み取ります。helm templateには読み取るべきクラスターがないため、これらを指定する必要があり、指定しない場合は「networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read」というメッセージを出して停止します。
externalEgressCIDRsには、Nexusが呼び出す必要のある名前空間外のすべてを列挙します。空の場合は何もないことを意味します。Harrowは自社のメールリレーとモデルサーバーのサブネットを列挙しています。ホスト型のモデルプロバイダー、クラスター外の社内サインインサービス、またはデータソースを接続する場合は、その範囲もここに入ります。これを1つ忘れることが、ノートPCでは機能するキーがインストール環境で失敗するよくある理由です。呼び出しがクラスターから外に出ないためです。
製品内の「発信を許可する宛先」(Where calls can leave)ページには、Nexusが到達できる外部のすべての場所、そこにある理由、および追加した人が一覧表示されます。それ以外のものはすべて、ルール名を示すコードとともに拒否されます。ページ上では、この拒否はEGRESS_DENIEDと表示されます。データレジデンシーも1つ上のレベルで同様に機能します。Enterpriseでは、「データの保管場所」(Where data lives)でデータの種類ごとにリージョンを設定でき、組織は自社の人工知能(AI)トラフィックをEUのプロバイダーに固定して、ルーターがそれ以外をすべて拒否するようにできます(第2.14章「AIプロバイダーとモデル」を参照)。マニフェストで宣言していないアドレスに到達しようとするアプリは、エッジでEGRESS_NOT_DECLAREDによって停止されます。
ローカル認証局からのサービス ID
Nexusはサービスメッシュなしで動作します。チャートにはistio.enabledという値があり、デフォルトはfalseで、これをオンにする理由はありません。代わりに、サービスは相互TLS(mTLS)、つまり双方が証明書を提示するトランスポート層セキュリティ(TLS)によって互いの身元を証明します。証明書は、チャートがcert-manager v1.21.3を通じて作成するローカル認証局(CA)から発行され、他に何もインストールする必要はありません。
チェーンは短くなっています。自己署名発行者であるnexus-selfsignedが、10年間有効なECDSA(楕円曲線デジタル署名アルゴリズム)P-256鍵であるCA証明書nexus-local-caに署名します。cert-managerは有効期限の30日前にこれを更新します。同じ名前の2つ目の発行者が、そこから他のすべてに署名します。
相互TLSを必要とするサービスを呼び出す各サービスは、自身のサービスアカウントにちなんで名付けられたSecret(<service-account>-client-tls)内に、独自のクライアント証明書を取得します。この証明書は、そのURI名としてサービスのSPIFFE IDを保持します。
spiffe://cluster.local/ns/<namespace>/sa/<service-account>
呼び出されたサービスは、その証明書をローカルCAと照合し、そこから呼び出し元が誰であるかを読み取ります。各ワークロードは、自身の証明書のSecret内にあるca.crtを通じてCAを信頼します。どのPodもCAの秘密鍵をマウントせず、どのConfigMapもCAを保持しません。nexus-probitasは、有効期限の15日前に更新される90日間有効な証明書であるnexus-probitas-tlsから、自身でTLSを提供します。
公開エッジは別になっており、tls.modeがそれを決定します。
existing:tls.existingSecretで指定された、お客様が作成したTLS Secret。cert-manager:tls.clusterIssuerで指定された、お客様が運用するClusterIssuerからの証明書。none: TLSはイングレスの手前、お客様自身のロードバランサーで終端します。その場合でも、ブラウザーはHTTPS経由でコンソールに到達する必要があります(第2.17章「トラブルシューティング」を参照)。
サインインセッション自体はHTTPSに依存しています。コンソールは自身のオリジンであるhttps://<hosts.console>からのサインインのみを受け入れ、セッションをSecure属性付きの__Host- Cookieに保持します。また、最初の管理者のパスキーには有効な証明書を持つページが必要です。プレーンなHTTP上のブラウザーや、証明書の警告が表示されている状態のブラウザーからは、まったくサインインできません。
クラスター内のデータ層は、デフォルトではTLSなしでサービスと通信します(dataTier.postgres.sslmode: disable)。そのトラフィックは上記のポリシーのもとで名前空間内に留まるためです。外部のPostgresは、第2.11章「バリエーション:外部ストア、TLS、イングレス」で説明されているように、ストアのSecret内にサーバーのCAを保持し、verify-fullまたはverify-caを使用します。
テレメトリはオフ
インストール環境からテレメトリーが外部に送信されることはありません。telemetry.enabledはfalseにしかなり得ず、チャートのスキーマは他のいかなる値も拒否します。データ層独自のレポート機能もオフになっているため、Neo4jは使用状況レポートを送信せず、Qdrantもテレメトリーを送信しません。
サインアップの制御
nexus-authにはサインアップするユーザーをスクリーニングするための2つの制御機能がありますが、どのインストール環境でも両方ともオフになっています。
CAPTCHA制御は、インターネット上のホスト型サービスを使用して各サインアップをチェックします。インストール環境はサインアップ時にインターネットに依存しないため、チャートはこれをオフにします。ネットワークスクリーニングは、サインアップ元を判断するために2つのGeoLite2データベースを必要とします。これらはライセンスが必要なダウンロードファイルであり、nexus-authイメージ内にも含まれておらず、チャートによってマウントもされません。また、このスクリーニングをオンにするための設定値もありません。これにより見送られるのは、データセンターやホスティングネットワークからのサインアップのスクリーニングです。
その代わりに得られるのが承認機能です。未知のユーザーによるサインアップは管理者が承認するまで保留され、それまでの間、そのユーザーには403 SIGNUP_REQUIRES_APPROVALが返されます。どちらのスイッチもこの動作を変えることはありません。
レート制限とトークンの有効期間
# harrow-values.yaml (Helm values): sign-in service
auth:
rateLimitPerMinute: 5000
accessTokenTTL: 15m
refreshTokenTTL: 12h
proxy:
trustedCIDRs: "10.244.0.0/16"auth.rateLimitPerMinuteは、サインインしている1人のユーザーが429を返されるまでに1分間にnexus-authに対して行える最大リクエスト数です。すべてのユーザーに同じ制限が適用され、プラットフォーム自身のサービスプリンシパルはこの制限の対象外です。デフォルトの5000は、1つのアカウントから秒間約83リクエストに相当し、人やスクリプトには十分な量です。制限を厳しくするには値を下げ、高度な自動化を行うには値を上げてください。1以上の整数を指定します。サインイン時のブルートフォース保護(アカウントのロックアウトや第2要素の試行制限)は別個の機能であり、ここでは設定されません。
制限を超えた呼び出し元にはRetry-Afterヘッダー付きのRATE_LIMITEDが返され、ボディには制限値と待機時間が含まれます。Enterpriseでは、管理者は「設定」の「レート制限」(Rate limits)で、スクリプトキーやアプリごと、および部門ごとに、1分あたりのリクエスト数や同時実行ジョブ数といったより細かい制限を設定できます。制限を超えた呼び出し元は待機を求められますが、遮断されることはありません。制限が撤回されると、部門の制限にフォールバックし、次にデフォルトにフォールバックします。
auth.accessTokenTTLとauth.refreshTokenTTLは、アクセストークンとリフレッシュトークンの有効期間を設定します。アクセストークンは1時間以下に保ってください。Nexus拡張機能用のソフトウェア開発キットであるPlugin SDKで構築されたプラグインは、有効期間が1時間を超えるセッショントークンをJWT_LIFETIME_EXCEEDEDで拒否します。
proxy.trustedCIDRsは、nexus-authがX-Forwarded-Forヘッダーを信頼するプロキシホップを指定します。デフォルトの10.42.0.0/16は、k3sのTraefikが実行されるPodネットワークです。別のディストリビューションでは、ご使用のイングレスコントローラーのPodネットワークに設定してください。これが間違っていると、nexus-authはすべてのリクエストがイングレスコントローラーから来ているものと見なすため、以下のアドレスルールはそのアドレスしか認識できなくなります。信頼されていないホップからの異なるX-Forwarded-Forによって、新しいレート制限ウィンドウが開かれることはありません。
会社のサインイン
ユーザーはパスキー、またはGoogleやGitHubを通じてサインインし、4つ目の方法として社内サインインがあります。管理者がパスワードだけでサインインすることは決してなく、2つ目の確認手段はパスキーです。
Communityには、OpenID Connect(OIDC)を通じた社内サインインが1つ含まれており、専用の設定画面とテスト結果が備わっています。Enterpriseでは、Security Assertion Markup Language(SAML)、全ユーザーへの強制適用、およびSystem for Cross-domain Identity Management(SCIM)を通じたディレクトリ同期が追加されます。
社内サインインを必須にできるのは、管理者が次の4つの手順を順番に完了した後だけです。それは、サインインサービスの接続、ドメインの証明、自身のアカウントを使ったそのサービス経由でのサインイン、そして緊急用アカウントの1つ指定です。それまでは「必須にする」(Require it)ボタンは閉じたままであり、ページにはコードCOMPANY_SIGNIN_STEPS_MISSINGとともに未完了の手順が表示されます。サインインサービスを変更するとテスト結果がクリアされるため、新しいサービスは再度テストする必要があります。
社内サインインサービスが応答しなくなると、サインインページにはIDP_UNREACHABLE(503)が表示されます。すでにサインインしているユーザーはサインイン状態が維持されます。管理者は緊急管理者サインインを使用できますが、これには金庫に保管された封印コードと管理者のパスキーが必要です。使用されるたびに、誰がどこから使用したかが監査ログに記録され、すべての管理者に即座に通知されます。そして4時間後、または社内サインインが復旧した時点で終了します。
組織内の全員が同じコンソールにサインインして日常業務を行いますが、オーナーと管理者には管理ページも表示されます。メンバーがそれらのページのいずれかを開くと、「管理者ではありません」(Not an administrator)ページが表示され、行がグレー表示になるとともに、それらを変更できる人の名前が示されます(NOT_AN_ADMINISTRATOR)。
不審なサインインとアドレスルール
Enterpriseでは、「不審なサインイン」(Suspicious sign-ins)に、新しい場所やデバイス、あるいはその日の早い時間帯のパスワード誤入力など、新規または異常に見えたパスワードサインインが一覧表示されます。それぞれについて、追加の確認を求めたか、サインインをブロックしたかなど、Nexusが行った処置が示されます。担当者は各行に対して、そのユーザーのサインインを終了させる「本人ではない」(Not them)、または「本人である」(It was them)で回答します。
「許可およびブロックされたアドレス」(Addresses allowed and blocked)には2つのリストがあります。許可された範囲は、オーナーと管理者がサインインできる唯一の場所であり、指定がない場合はどこからでもサインインできます。メンバーは影響を受けません。ブロックされたアドレスは、誰もサインインできない場所です。各エントリには、誰が追加したかと、いつ解除されるかが記録されます。すべての変更はまずあなた自身の現在のアドレスに対してテストされ、あなた自身をロックアウトしてしまうような変更は何も保存されずに拒否されます。範囲を厳しくすると、そこからのアクセスが許可されなくなった管理者のサインインは即座に終了します。
キーと証明書
各組織のデータは独自の鍵でロックされ、お客様が選択したカストディアン(ハードウェアセキュリティモジュールまたはソフトウェア)によって保持されます。「鍵」(Keys)ページには、組織の鍵のバージョンと次回のローテーション予定日が表示されます。あるバージョンが最新でなくなった後も、その下でラップされているものが何もなくなってしまうまでは読み取り可能な状態が保たれます。鍵自体は決して表示されず、そのフィンガープリントのみが表示されます。
鍵を破棄することが、Nexusにおける消去の方法です。「鍵と消去」(Keys and erasure)で「消去」(Erase)を実行すると、1人の個人または組織全体の鍵が破棄され、バックアップを含め、その鍵でロックされていたすべてのものがどこでも読み取り不能になります。元に戻すことはできないため、書面による理由と2人目の承認者を求めます。何が誰によって消去されたかを記録した受領証が残されますが、内容自体は決して記録されません。
「期限切れ間近の鍵」(Keys about to run out)には、まもなく有効期限が切れるプロバイダートークンや証明書、誰にいつ警告されるか、そして期限が切れた場合に何が停止するかが一覧表示されます。実行中の作業は停止せず、AIルーターは別の鍵にフォールバックします。
四つ目(Four-eyes)承認
Enterpriseでは、ポリシーによって機密性の高い変更を2人目の承認者が確認するまで保留にすることができます。「四眼承認」(Four-eyes approvals)には、承認待ちの各リクエストについて、誰が要求したか、理由、必要な承認数、および失効日時が一覧表示されます。誰も自分自身のリクエストを承認することはできず(TRUST_APPROVAL_SELF_APPROVAL)、すでに決定されたリクエストはAPPROVAL_ALREADY_DECIDEDを返します。リクエストを却下するには理由が必要です。期限内に誰も決定しなかったリクエストは失効し、何も変更されません。どの変更がここで待機するかは、2人目の承認者を求めるポリシーによって設定されます。バックアップの復元やシートの追加は、このガイドの他の場所で触れられている2つの例です。
他のユーザーが見ている画面の確認
組織内でのサポートでは、同僚に見えているのと同じようにページを見ることが必要になる場合があります。Enterpriseでは、「同僚の視点で表示」(See it as they do)機能により、2つ目の確認と書面による理由の提出を経た上で、あるメンバーに見えている状態のコンソールの読み取り専用ビューが管理者に30分間提供されます。対象のメンバーにはその旨が通知されます。メンバーのプライベートな項目(メール、ノートブック、ダイレクトメッセージ、およびアシスタントがそのメンバーのために記憶している内容)は決して表示されず、期間中は上部にバナーが表示され続け、すべてが監査ログに記録されます。
大きな変更には、それ自体に一時停止のステップが設けられています。広範囲に影響する変更が保存される前に、「この変更が行われる前に」(Before this change happens)オーバーレイに、何が機能しなくなるか、何に注意が必要か、何が影響を受けないかが一覧表示されます。変更はブロックされません。よく考えるのに十分なだけの手間がかけられており、Enterpriseでは機密性の高い変更は2人目の承認者も待つことになります。
監査の保持とストリーミング
監査ログは誰が何をしたかを新しい順に記録し、フィルタリングやエクスポートが可能です。Communityでは30日間保持され、スプレッドシートファイルをエクスポートできます。Enterpriseでは、「設定」の下にある「保持と破棄」(Keeping and letting go)ページでお客様の保持ポリシーが定める期間だけ保持され、セキュリティ監視システムにストリーミングされます。拒否も記録されるため、成功したユーザーだけでなく、拒否されたユーザーも行を残します。その背後にあるガバナンス記録は組織ごとにチェーン化されているため、各組織は他の組織のものを見ることなく、自組織のスライスを確認できます。
データベースロール
Nexusはデータベースのスーパーユーザーとしてサービスを実行することは決してありません。コンソールのフロントエンド向けバックエンド(BFF)の1回限りのプロビジョニング手順を除き、クラスターのスーパーユーザーを保持する唯一の部分であるブートストラップフックは、以下のロールを作成します。
| ロール | その内容 |
|---|---|
nexus_migrator |
LOGIN NOSUPERUSER NOBYPASSRLS CREATEROLE。nexusデータベースとマイグレーションが作成するすべてのオブジェクトを所有し、マイグレーションが指定するロールを作成します。 |
nexus_runtime |
ログインできないグループ。接続とスキーマの使用を許可しますが、テーブルの権限は付与しません。 |
nexus_auth, nexus_gateway, nexus_graphrag, nexus_skills |
各サービス独自のログイン。nexus_runtimeのメンバーであるNOSUPERUSER NOBYPASSRLSで、自身のマイグレーションによって自身のテーブルのみが付与され、他には何も付与されません。 |
nexus_ledger_reader |
wait-for-schemaのinitコンテナのために、1つのテーブル(リリース台帳)のみを読み取ります。他の権限付与はありません。 |
どのサービスロールも自身のテーブルを所有しておらず、行レベルセキュリティ(RLS)をバイパスすることもできないため、すべてのサービス接続にすべてのRLSポリシーが適用されます。nexus-authのテーブルには行レベルセキュリティが強制されるため、その所有者であってもこれに従う必要があります。サーバー上にSUPERUSERまたはBYPASSRLSを持つnexusという名前のロールがすでに存在する場合、ブートストラップは続行を拒否し、「role nexus exists with SUPERUSER or BYPASSRLS on this server; nexus_migrator will not be made a member of it. Nothing more was done.」というメッセージを出します。その属性を削除するか、別のサーバーを使用してください。




