3.5. Web コンソールを使用して Apicurio Registry 設定を行う
管理者は、Apicurio Registry Web コンソールを使用して、実行時に Apicurio Registry の動的な設定を行うことができます。認証、承認、API 互換性などの機能の設定オプションを管理できます。
Apicurio Registry のデプロイ時に認証がすでに有効になっている場合は、認証と承認の設定は Web コンソールにのみ表示されます。詳細は、OpenShift への Red Hat build of Apicurio Registry のインストールとデプロイ を参照してください。
前提条件
- Apicurio Registry はすでにデプロイされています。
管理者アクセスで Apicurio Registry Web コンソールにログインしている。
http://MY_REGISTRY_UI_URL/
手順
- Apicurio Registry Web コンソールで、Settings タブをクリックします。
Apicurio Registry 用の設定を選択します。
Expand 表3.1 認証設定 設定 説明 HTTP Basic 認証
認証がすでに有効になっている場合にのみ表示されます (デプロイメント中)。選択すると、Apicurio Registry ユーザーは、OAuth に加えて HTTP 基本認証を使用して認証できます。デフォルトでは選択されていません。
Expand 表3.2 承認設定 設定 説明 匿名の読み取りアクセス
認証が有効な場合のみ表示されます。選択すると、Apicurio Registry は、認証情報がない匿名ユーザーからの要求に対して、読み取り専用アクセスを許可します。この設定は、Apicurio Registry を使用してスキーマまたは API を外部に公開する場合に便利です。デフォルトでは選択されていません。
アーティファクト所有者のみの承認
認証が有効な場合のみ表示されます。選択すると、アーティファクトを作成したユーザーのみがそのアーティファクトを変更できます。デフォルトでは選択されていません。
アーティファクトグループ所有者のみの承認
認証がすでに有効で、Artifact owner-only authorization も有効な場合にのみ表示されます。選択すると、アーティファクトグループを作成したユーザーのみが、そのアーティファクトグループへの書き込みアクセス権 (そのグループのアーティファクトの追加や削除など) を持ちます。デフォルトでは選択されていません。
認証された読み取りアクセス
認証が有効な場合のみ表示されます。選択すると、Apicurio Registry は、ユーザーロールに関係なく、認証されたユーザーからのリクエストに対して、少なくとも読み取り専用アクセスを許可します。デフォルトでは選択されていません。
Expand 表3.3 互換性設定 設定 説明 正規ハッシュモード (互換性 API)
選択すると、Schema Registry 互換性 API はコンテンツの通常のハッシュではなく標準的なハッシュを使用します。
レガシー ID モード (互換 API)
選択すると、Confluent Schema Registry 互換性 API は
contentIdの代わりにglobalIdをアーティファクト識別子として使用します。返されるサブジェクトの最大数 (互換性 API)
Confluent Schema Registry 互換性 API (
/subjectsエンドポイント用) によって返されるサブジェクトの最大数を決定します。Expand 表3.4 Web コンソールの設定 設定 説明 ダウンロードリンクの有効期限
セキュリティー上の理由により期限切れになるまでに、
.zipダウンロードファイルへの生成されたリンクがアクティブな秒数 (例: Apicurio Registry からアーティファクトデータをエクスポートする場合)。デフォルトは 30 秒です。Expand 表3.5 Semantic Versioning 設定 設定 説明 semver ブランチを自動的に作成する
有効にすると、メジャー ('A.x') およびマイナー ('A.B.x') アーティファクトバージョンのブランチが自動的に作成または更新されます。
すべてのバージョン番号が 'semver' と互換性があることを確認する
有効にすると、すべてのアーティファクトバージョンが Semantic Versioning 2 形式 (https://semver.org) に準拠していることが検証されます。
Expand 表3.6 追加のプロパティー 設定 説明 アーティファクトの削除
選択すると、ユーザーは Core Registry API を使用して Apicurio Registry 内のアーティファクトを削除できるようになります。デフォルトでは選択されていません。
アーティファクトバージョンの削除
選択すると、ユーザーは Core Registry API を使用して Apicurio Registry 内のアーティファクトバージョンを削除できるようになります。デフォルトでは選択されていません。
グループの削除
選択すると、ユーザーは Core Registry API を使用して Apicurio Registry 内のグループを削除できるようになります。デフォルトでは選択されていません。
ストレージ読み取り専用モード
選択すると、レジストリーはストレージへの書き込み操作に対してエラーを返します (このプロパティーを除く)。デフォルトでは有効になっていません。