App ConfigurationSDK
App Configuration のクライアントSDKは、Android、 JavaScript,、Reactに対応しており、サーバーSDKは Node、 Python、Go、 Java に対応しています。また、管理用SDKはGoに対応しており、これらを活用することで、Webおよびモバイルアプリケーション、マイクロサービス、分散環境との統合が可能になります。
クライアント・サイド SDK およびサーバー・サイド SDK
様々なSDKの違いを理解することで、ユースケースに合わせてSDKの種類を決めることができます。
SDK のタイプ
App Configuration でサポートされる SDK は、以下のとおりです。
- サーバー・サイド SDK
- クライアント・サイド SDK
- 管理 SDK
機能フラグおよびプロパティー値の評価に便利な SDK は、デプロイメント環境によってサーバー・サイドまたはクライアント・サイドに大別されます。 これらの SDK をアプリケーションに統合して、セグメント・ターゲティング・ルール (あれば) を検討することにより、機能またはプロパティーの値を評価できます。
評価用SDKは、 App Configuration サービスから最新の設定データを取得し、サービス設定の変更がリアルタイムでアプリケーションに反映されるようにします。
Admin SDK を使用すると、環境、コレクション、機能フラグ、プロパティ、およびセグメントの設定を作成および管理できます。 IBM Cloud ダッシュボードや IBM Cloud CLIの代替手段として、Admin SDKを使用することで、アプリケーション内からサービス設定をプログラムで管理することができます。
現在使用可能な Go 言語管理 SDK は、Go アプリケーションと統合されています。
クライアントサイド、サーバーサイド、管理者SDKの違い
このセクションでは、クライアントサイドSDK、サーバーサイドSDK、管理者SDKの違いについて説明します。
|SDKの種類|詳細|SDKと統合ドキュメントへのリンク|SDKと統合ドキュメントへのリンク|SDKと統合ドキュメントへのリンク | -- | -- | -- | |サーバーサイド|これらのSDKは、マルチユーザーシステム向けに設計されており、企業内ネットワークやWebサーバーなど、信頼できる環境での使用を想定しています。|
Node SDK
ドキュメント
Python SDK
ドキュメント
Go SDK
ドキュメント
Java SDK
ドキュメント | |クライアント側|これらのSDKは、Webおよびモバイルアプリケーション向けに設計されています。|
Android SDK
ドキュメント
JavaScript SDK
ドキュメント
React SDK
ドキュメント|
|Admin SDK|Admin SDKは、 App Configuration のサービスインスタンス管理を行うために設計されています。 このSDKを使用して、コレクション、環境、機能フラグ、プロパティなどの App Configuration リソースを作成・管理します。| App Configuration Go用Admin SDK|
インストールおよび技術的な概念について詳しくは、SDK の「README ファイル」ドキュメントを参照してください。
ナビゲーション・メニューの SDK の下にある App Configuration コンソールからこれらの資料にアクセスして SDK をダウンロードすることもできます。
APIキーと役割
各SDKは、 App Configuration サービスインスタンスへのアクセスを認証および許可するために、初期化時にAPI Keyを必要とします。 本サービスへのアクセスには、以下のユーザー・ロールがサポートされています:
- マネージャー
- リーダー
- ライター
- 構成オペレーター
- Client SDK
SDKタイプ別推奨ロール
適切かつ最小権限のアクセスを確保するため、SDKのAPIキーを生成する際には以下のロールを使用してください:
- サーバーサイドSDK:バックエンドサービスが使用する設定データへの読み取り専用アクセスを許可するReaderロールを使用します。
- クライアント側SDK:ブラウザベースのアプリケーションに適した限定的なアクセス権限を持つクライアントSDKロールを使用します。
- 管理者SDK:管理操作のための完全な管理権限を付与するManagerロールを使用します。