ネットワークとセキュリティ
Human Plugin はネットワークを信頼します。誰が到達できるかは、お客様が管理します。
信頼境界
Human Plugin はプレーンな HTTP を提供し、呼び出し元の認証も認可も行わず、リクエストをクライアントごとにスコープすることもなく、TLS も終端しません。ポートに到達できる人は誰でも、お客様のアクセスキーでプロセスを作成でき、インストール内のあらゆるプロセスを読み取れます。
そのため、次のようにしてください。
- ポートはバックエンドにのみ公開します。localhost、サイドカー、またはネットワークポリシーやセキュリティグループを設定したプライベートネットワークを使用してください。
- パブリックな ingress やロードバランサー経由で公開しないでください。
- TLS や呼び出し元の認証が必要な場合は、Human Plugin の前段で、お客様が運用するゲートウェイ、サービスメッシュ、またはリバースプロキシによって提供してください。
Human Plugin が行う接続
| 接続先 | タイミング | 備考 |
|---|---|---|
humantoken.unico.app (443) | プロセスの実行中 | お客様のアクセスキーを使用します |
human-token-assets.unico.app (443) | 起動時に 1 回 | 属性カタログ |
pkg.unico.run (443) | イメージのプル時 | Unico のレジストリです。Docker または kubelet に必要で、Human Plugin 自体には不要です |
| お客様の PostgreSQL | 常時 | デフォルトで SSL が必須です |
これらの接続先を、お客様のエグレスルールで許可してください。
シークレット
アクセスキーとデータベースのパスワードは環境変数から渡されます。シークレットストアから注入してください。Human Plugin がこれらをログに出力することはありません。どちらかを変更した場合は、コンテナの再起動が必要です。
データの取り扱い
- 機密データはお客様のインフラ内に留まります。
credentialで送信するドキュメント、クライアント ID、およびインテリジェンスは、お客様のデータベースに保存されます。 - レスポンスには Human Token が含まれ、Journey フローでは SDK トークンとリンクも含まれます。Human Plugin はこれらをログに出力しません。お客様のゲートウェイやアプリケーションのログにも出力しないでください。
- Human Plugin はセルフィーを保存せず、セルフィーのレスポンスもキャッシュしません。お客様のシステム内でも生体データとして扱ってください。
- Human Plugin のログに、画像、ドキュメントの値、トークン、アクセスキーが含まれることはありません。
- クライアント間またはブランド間の分離は、インストールとそのデータベースによって実現されます。
clientIdはインテリジェンスの集計用ディメンションであり、アクセス境界ではありません。