プログラムによる Cloud Manager へのアクセス

項目一覧

プログラムによる組織へのアクセスを管理

プロジェクトへのプログラムによるアクセスを管理
API リクエストを作成

Cloud Manager は、 2024年8月30日でMongoDB 3.6と4.0のオートメーション、バックアップおよびモニタリングのサポートを終了します。 MongoDB の配置をアップグレードするか、Atlas に移行してください。

Cloud Managerへのプログラムによるアクセスのための OAuth 2.0認証はプレビュー機能として利用できます。: 機能および関連するドキュメントは、プレビュー期間中にいつでも変更される可能性があります。 OAuth2.0 認証を使用するには、 Cloud Manager Public APIへのリクエストで使用するサービスアカウントを作成します。

APIのみを使用して組織またはプロジェクトへのプログラムによるアクセスを許可するには、 APIキーまたはサービスアカウントを作成します。これにより、ユーザー名とパスワードとして機能するキーとアクセストークンがネットワーク経由で送信されることがなくなります。 APIキーとサービスアカウント

UIを介してCloud Managerにログするために使用することはできません。
APIキーとサービスアカウントで、エラーなくAPIエンドポイントを呼び出せるようにするには、ユーザーと同様にロールを付与する必要があります。
は 1 つの組織に属していますが、その組織内の任意の数のプロジェクトにアクセスできます。

これら 2 つの認証方法の詳細については、「認証」を参照してください。

プログラムによる組織へのアクセスを管理

注意

必要な権限

任意のロールを持つ組織への、プログラムによるアクセスを表示できます。

その他のアクションを実行するには、Organization Owner ロールが必要です。

組織へのプログラムによるアクセスの付与

APIキーまたはサービスアカウントを使用して、組織へのプログラムによるアクセスを許可するには、次の手順に従います。これら 2 つの認証方法の詳細については、「認証」を参照してください。

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、{0Organization Settings ページにGoします。

まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーションバーのOrganizationsメニュー
[Organizations] メニューの横にある [Organization Settings] アイコンをクリックします。
[ Organization Settings ]ページが表示されます。

Organization Access Managerページに移動します。

サイドバーの Access Manager をクリックします。

[ Organization Access Manager ]ページが表示されます。

[0}Add newApplicationAPI Key をクリックします。

API Key Informationフォームを完了します。

Add API KeyページのAPI Key Informationステップから以下の操作を行います。

フィールド	値
説明	新しいAPIキーの説明を入力します。
組織権限	API キーの新しいロールを選択します。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Next

この API キーのアクセスリスト値を追加します。

Add API KeyページのPrivate Key & Access Listステップから、 Add Access List Entryをクリックします。

このAPIキーは、次のいずれかを選択できます。

Cloud Manager が API リクエストを受け入れる IPv4 アドレスを入力するか、あるいは
Cloud Manager にアクセスするために使用しているホストがAPIリクエストを行う場合は、 Use Current IP Addressをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Save

警告

このページを終了する前に秘密キーをコピーする

Cloud Manager は、このページにPrivate Keyを 1 回表示します。 [ Copyをクリックして、秘密キーをクリップボードに追加します。この秘密キーを他のパスワードと同様に安全に保存します。

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Organization Settings ページにGoします。

まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーションバーのOrganizationsメニュー
[Organizations] メニューの横にある [Organization Settings] アイコンをクリックします。
[ Organization Settings ]ページが表示されます。

Organization Access Managerページに移動します。

サイドバーの Access Manager をクリックします。

[ Organization Access Manager ]ページが表示されます。

[0}Add newApplicationService Account をクリックします。

サービスアカウント情報を入力します。

Nameと入力します。
Descriptionと入力します。
Client Secret Expiration メニューから期間を選択します。
[ Organization Permissions ] メニューから、サービスアカウントの新しいロールを選択します。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Create

をコピーして保存してください。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\"Client Secret \">

クライアントシークレットは、アクセストークンを作成するときにパスワードとして機能します。

警告

クライアントの秘密をすべて見ることができるのはこの時だけです。Copy をクリックして、安全な場所に保存します。それ以外の場合は、新しいクライアントシークレットを生成する必要があります。

API Access List Entryを追加します。

[Add Access List Entry] をクリックします。
Cloud Managerがこのサービス APIIPアカウントのAPIリクエストを受け入れるIPアドレスまたは CIDR ブロックを入力します。Cloud Manager
Use Current IP AddressCloud Managerにアクセスするために使用しているホストもこのサービスアカウントを使用してAPIリクエストを行う場合は、をクリックすることもできます。
[Save] をクリックします。

組織へのプログラムによるアクセスの表示

組織へのアクセス権を持つすべてのAPIキーまたはサービスアカウントの詳細を表示できます。

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Organization Settings ページにGoします。

まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーションバーのOrganizationsメニュー
[Organizations] メニューの横にある [Organization Settings] アイコンをクリックします。
[ Organization Settings ]ページが表示されます。

Organization Access Managerページに移動します。

サイドバーの Access Manager をクリックします。

[ Organization Access Manager ]ページが表示されます。

[]Applications タブをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">API Keys

View Detailsに移動します。

APIキーの横にある [] をクリックします。。
[View Details] をクリックします。
<Public Key> API Key Detailsモーダルには次の内容が表示されます。
- 難読化されたPrivate Key 。
- キーが最後に使用された日付。
- キーが作成された日付。
- アクセスリスト内のキーがあるIPv4アドレス。
- キーがアクセス権を付与されたプロジェクト。

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Organization Settings ページにGoします。

まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーションバーのOrganizationsメニュー
[Organizations] メニューの横にある [Organization Settings] アイコンをクリックします。
[ Organization Settings ]ページが表示されます。

Organization Access Managerページに移動します。

サイドバーの Access Manager をクリックします。

[ Organization Access Manager ]ページが表示されます。

[]Applications タブをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Service Accounts

組織へのアクセス権を持つすべてのサービスアカウントが表示されます。

サービスアカウントの名前をクリックすると、次のような詳細が表示されます。

サービスアカウントの難読化されたクライアントシークレット
クライアントシークレットが最後に使用された日付
クライアントシークレットが作成された日付
サービスアカウントがAPIにアクセスできるIPアドレス
サービスアカウントに割り当てられたロール

組織へのプログラムによるアクセスを更新

組織内のAPIキーまたはサービスアカウントのロール、説明、またはアクセスリストを変更できます。サービスアカウント用に新しいクライアントシークレットを生成することもできます。

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Organization Settings ページにGoします。

まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーションバーのOrganizationsメニュー
[Organizations] メニューの横にある [Organization Settings] アイコンをクリックします。
[ Organization Settings ]ページが表示されます。

Organization Access Managerページに移動します。

サイドバーの Access Manager をクリックします。

[ Organization Access Manager ]ページが表示されます。

[]Applications タブをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">API Keys

編集する API キーを選択します。

をクリックします変更するAPIキーの横にある。
[Edit] をクリックします。

API Key Informationフォームを完了します。

Add API KeyページのAPI Key Informationステップから以下の操作を行います。

フィールド	値
説明	新しいAPIキーの説明を入力します。
組織権限	API キーの新しいロールを選択します。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Next

この API キーのアクセスリスト値を追加します。

Add API KeyページのPrivate Key & Access Listステップから、 Add Access List Entryをクリックします。

このAPIキーは、次のいずれかを選択できます。

Cloud Manager が API リクエストを受け入れる IPv4 アドレスを入力するか、あるいは
Cloud Manager にアクセスするために使用しているホストがAPIリクエストを行う場合は、 Use Current IP Addressをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Save

警告

このページを終了する前に秘密キーをコピーする

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Organization Settings ページにGoします。

まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーションバーのOrganizationsメニュー
[Organizations] メニューの横にある [Organization Settings] アイコンをクリックします。
[ Organization Settings ]ページが表示されます。

Organization Access Managerページに移動します。

サイドバーの Access Manager をクリックします。

[ Organization Access Manager ]ページが表示されます。

[]Applications タブをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Service Accounts

サービスアカウントの名前をクリックします。

Service Account Infoを編集します。

またはを変更するには、NameDescription をクリックします。

新しいクライアントシークレットを生成します。

クリック Generate New Client Secret
メニューからクライアントシークレットの期間を選択します。この期間が経過すると、クライアントシークレットは期限切れになります。
[Generate New] をクリックします。
Copy をクリックして、クライアントシークレットを安全な場所に保存します。この時間は、完全なクライアントシークレットを表示できる唯一の時間です。

Organization Permissionsを編集します。

[Edit Permissions] をクリックします。
Organization Permissionsメニューから、サービスアカウントの新しいロールを選択します。
[Save and next] をクリックします。
重要
サービスアカウントの認証情報は、有効期限が切れるか、ユーザーが取り消すまでアクティブのままになります。

API Access Listを編集します。

Cloud Managerがこのサービス APIIPアカウントのAPIリクエストを受け入れるIPアドレスまたは CIDR ブロックを追加するには、[]Cloud ManagerAdd Access List Entry IPをクリックしてIPアドレスを入力します。
Use Current IP AddressCloud Managerにアクセスするために使用しているホストもこのサービスアカウントを使用してAPIリクエストを行う場合は、をクリックすることもできます。
アクセスリストからIPアドレスを削除するには、クリックします許可されIP 。
[Save] をクリックします。

組織へのプログラムによるアクセスを取り消す

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Organization Settings ページにGoします。

まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーションバーのOrganizationsメニュー
[Organizations] メニューの横にある [Organization Settings] アイコンをクリックします。
[ Organization Settings ]ページが表示されます。

Organization Access Managerページに移動します。

サイドバーの Access Manager をクリックします。

[ Organization Access Manager ]ページが表示されます。

[]Applications タブをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">API Keys

API キーを削除します。

をクリックしますを、削除するAPIキーの横にあります。
このAPIキーを削除するかどうかを確認するには [ Deleteをクリックし、組織内にキーを残す場合は [ Cancelをクリックします。

注意

組織からAPIキーを削除すると、キーにアクセスが付与されていたすべてのプロジェクトからそのキーも削除されます。

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Organization Settings ページにGoします。

まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーションバーのOrganizationsメニュー
[Organizations] メニューの横にある [Organization Settings] アイコンをクリックします。
[ Organization Settings ]ページが表示されます。

Organization Access Managerページに移動します。

サイドバーの Access Manager をクリックします。

[ Organization Access Manager ]ページが表示されます。

[]Applications タブをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Service Accounts

サービスアカウントを削除します。

Actions削除するサービスアカウントの右側にあるの下のアイコンをクリックします。
[Delete] をクリックします。

組織からサービスアカウントを削除すると、サービスアカウントがアクセスを許可されていたすべてのプロジェクトからもそのサービスアカウントが削除されます。

プロジェクトへのプログラムによるアクセスを管理

注意

必要な権限

任意のロールを持つプロジェクトへの、プログラムによるアクセスを表示できます。

その他のアクションを実行するには、Project User Admin ロールが必要です。

プロジェクトへのプログラムによるアクセスの付与

APIキーまたはサービスアカウントのいずれかを使用して、プロジェクトへのプログラムによるアクセスを許可するには、次の手順に従います。これら 2 つの認証方法の詳細については、「認証」を参照してください。

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Project Access Manager ページにGoします。

まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーションバーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーションバーのProjectsメニューから目的のプロジェクトを選択します。
次のいずれかの手順を行います。
- ナビゲーションバーのAccess ManagerメニューからProject Accessを選択します。
- Projectsメニューの横にある次を展開します[ Options ] メニューで [] をクリックし、サイドバーの [ Access Manager Project Settingsをクリックします。
プロジェクトアクセスマネージャーページが表示されます。

[0}Create ApplicationAPI Key をクリックします。

API Key Informationフォームを完了します。

Add API KeyページのAPI Key Informationステップから以下の操作を行います。

フィールド	値
説明	新しいAPIキーの説明を入力します。
プロジェクト権限	API キーの新しいロールを選択します。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Next

この API キーのアクセスリスト値を追加します。

Add API KeyページのPrivate Key & Access Listステップから、 Add Access List Entryをクリックします。

このAPIキーは、次のいずれかを選択できます。

Cloud Manager が API リクエストを受け入れる IPv4 アドレスを入力するか、あるいは
Cloud Manager にアクセスするために使用しているホストがAPIリクエストを行う場合は、 Use Current IP Addressをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Save

警告

このページを終了する前に秘密キーをコピーする

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Project Access Manager ページにGoします。

まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーションバーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーションバーのProjectsメニューから目的のプロジェクトを選択します。
次のいずれかの手順を行います。
- ナビゲーションバーのAccess ManagerメニューからProject Accessを選択します。
- Projectsメニューの横にある次を展開します[ Options ] メニューで [] をクリックし、サイドバーの [ Access Manager Project Settingsをクリックします。
プロジェクトアクセスマネージャーページが表示されます。

[0}Create ApplicationService Account をクリックします。

サービスアカウント情報を入力します。

Nameと入力します。
Descriptionと入力します。
Client Secret Expiration メニューから期間を選択します。
[Project Permissions（プロジェクト権限）] メニューから、サービスアカウントの新しいロールを選択します。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Create

をコピーして保存してください。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\"Client Secret \">

クライアントシークレットは、アクセストークンを作成するときにパスワードとして機能します。

警告

API Access List Entryを追加します。

[Add Access List Entry] をクリックします。
Cloud Managerがこのサービス APIIPアカウントのAPIリクエストを受け入れるIPアドレスまたは CIDR ブロックを入力します。Cloud Manager
Use Current IP AddressCloud Managerにアクセスするために使用しているホストもこのサービスアカウントを使用してAPIリクエストを行う場合は、をクリックすることもできます。
[Save] をクリックします。

プロジェクトへのプログラムによるアクセスの表示

プロジェクトへのアクセス権を持つすべてのAPIキーまたはサービスアカウントの詳細を表示できます。

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Project Access Manager ページにGoします。

まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーションバーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーションバーのProjectsメニューから目的のプロジェクトを選択します。
次のいずれかの手順を行います。
- ナビゲーションバーのAccess ManagerメニューからProject Accessを選択します。
- Projectsメニューの横にある次を展開します[ Options ] メニューで [] をクリックし、サイドバーの [ Access Manager Project Settingsをクリックします。
プロジェクトアクセスマネージャーページが表示されます。

[]Applications タブをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">API Keys

View Detailsに移動します。

APIキーの横にある [] をクリックします。。
[View Details] をクリックします。
<Public Key> API Key Detailsモーダルには次の内容が表示されます。
- 難読化されたPrivate Key 。
- キーが最後に使用された日付。
- キーが作成された日付。
- アクセスリスト内のキーがあるIPv4アドレス。
- キーがアクセス権を付与されたプロジェクト。

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Project Access Manager ページにGoします。

まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーションバーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーションバーのProjectsメニューから目的のプロジェクトを選択します。
次のいずれかの手順を行います。
- ナビゲーションバーのAccess ManagerメニューからProject Accessを選択します。
- Projectsメニューの横にある次を展開します[ Options ] メニューで [] をクリックし、サイドバーの [ Access Manager Project Settingsをクリックします。
プロジェクトアクセスマネージャーページが表示されます。

[]Applications タブをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Service Accounts

プロジェクトへのアクセス権を持つすべてのサービスアカウントが表示されます。

サービスアカウントの名前をクリックすると、次のような詳細が表示されます。

サービスアカウントの難読化されたクライアントシークレット
クライアントシークレットが最後に使用された日付
クライアントシークレットが作成された日付
サービスアカウントがAPIにアクセスできるIPアドレス
サービスアカウントに割り当てられたロール

プロジェクトへのプログラムによるアクセスを更新

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Project Access Manager ページにGoします。

まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーションバーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーションバーのProjectsメニューから目的のプロジェクトを選択します。
次のいずれかの手順を行います。
- ナビゲーションバーのAccess ManagerメニューからProject Accessを選択します。
- Projectsメニューの横にある次を展開します[ Options ] メニューで [] をクリックし、サイドバーの [ Access Manager Project Settingsをクリックします。
プロジェクトアクセスマネージャーページが表示されます。

[]Applications タブをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">API Keys

編集する API キーを選択します。

をクリックします変更するAPIキーの横にある。
[Edit] をクリックします。

API Key Informationフォームを完了します。

Add API KeyページのAPI Key Informationステップから以下の操作を行います。

フィールド	値
説明	新しいAPIキーの説明を入力します。
プロジェクト権限	API キーの新しいロールを選択します。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Next

この API キーのアクセスリスト値を追加します。

Add API KeyページのPrivate Key & Access Listステップから、 Add Access List Entryをクリックします。

このAPIキーは、次のいずれかを選択できます。

Cloud Manager が API リクエストを受け入れる IPv4 アドレスを入力するか、あるいは
Cloud Manager にアクセスするために使用しているホストがAPIリクエストを行う場合は、 Use Current IP Addressをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Save

警告

このページを終了する前に秘密キーをコピーする

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Project Access Manager ページにGoします。

まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーションバーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーションバーのProjectsメニューから目的のプロジェクトを選択します。
次のいずれかの手順を行います。
- ナビゲーションバーのAccess ManagerメニューからProject Accessを選択します。
- Projectsメニューの横にある次を展開します[ Options ] メニューで [] をクリックし、サイドバーの [ Access Manager Project Settingsをクリックします。
プロジェクトアクセスマネージャーページが表示されます。

[]Applications タブをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Service Accounts

サービスアカウントの名前をクリックします。

Service Account Infoを編集します。

NameまたはDescription を変更するには、[] をクリックします。

新しいクライアントシークレットを生成します。

クリック Generate New Client Secret
メニューからクライアントシークレットの期間を選択します。この期間が経過すると、クライアントシークレットは期限切れになります。
[Generate New] をクリックします。
Copy をクリックして、クライアントシークレットを安全な場所に保存します。この時間は、完全なクライアントシークレットを表示できる唯一の時間です。

Project Permissionsを編集します。

[Edit Permissions] をクリックします。
Project Permissionsメニューから、サービスアカウントの新しいロールを選択します。
[Save and next] をクリックします。
重要
サービスアカウントの認証情報は、有効期限が切れるか、ユーザーが取り消すまでアクティブのままになります。

API Access Listを編集します。

Cloud Managerがこのサービス APIIPアカウントのAPIリクエストを受け入れるIPアドレスまたは CIDR ブロックを追加するには、[]Cloud ManagerAdd Access List Entry IPをクリックしてIPアドレスを入力します。
Use Current IP AddressCloud Managerにアクセスするために使用しているホストもこのサービスアカウントを使用してAPIリクエストを行う場合は、をクリックすることもできます。
アクセスリストからIPアドレスを削除するには、クリックします許可されIP 。
[Save] をクリックします。

プロジェクトへのプログラムによるアクセスを取り消す

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Project Access Manager ページにGoします。

まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーションバーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーションバーのProjectsメニューから目的のプロジェクトを選択します。
次のいずれかの手順を行います。
- ナビゲーションバーのAccess ManagerメニューからProject Accessを選択します。
- Projectsメニューの横にある次を展開します[ Options ] メニューで [] をクリックし、サイドバーの [ Access Manager Project Settingsをクリックします。
プロジェクトアクセスマネージャーページが表示されます。

[]API Keys タブをクリックします。

API キーを削除します。

をクリックしますを、削除するAPIキーの横にあります。
このAPIキーを削除するかどうかを確認するには [ Deleteをクリックし、組織内にキーを残す場合は [ Cancelをクリックします。

注意

組織からAPIキーを削除すると、キーにアクセスが付与されていたすべてのプロジェクトからそのキーも削除されます。

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Project Access Manager ページにGoします。

まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーションバーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーションバーのProjectsメニューから目的のプロジェクトを選択します。
次のいずれかの手順を行います。
- ナビゲーションバーのAccess ManagerメニューからProject Accessを選択します。
- Projectsメニューの横にある次を展開します[ Options ] メニューで [] をクリックし、サイドバーの [ Access Manager Project Settingsをクリックします。
プロジェクトアクセスマネージャーページが表示されます。

[]Applications タブをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Service Accounts

サービスアカウントを削除します。

プロジェクトから削除するサービスアカウントの右側にあるの下のアイコンをクリックします。Actions
[Remove from this project] をクリックします。

重要

サービスアカウントは引き続き組織内に存在し、有効期限が切れるか手動で取り消されるまで、既存の認証情報はアクティブのままになります。

API リクエストを行う

Cloud Manager APIは、 APIキーまたはサービスアカウントの 2 つの認証方法のいずれかを使用してリクエストを認証します。次の手順を完了するには、希望認証方法を構成するときに保存したキーまたはシークレットが必要です。

リクエストは次の例のようになります。ここで、 {PUBLIC-KEY} は API 公開キー、 {PRIVATE-KEY} は対応する秘密キーです。

次のサンプルGETリクエストは、現在のユーザーのすべてのプロジェクトを返します。

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --include \
     --request GET "https://cloud.mongodb.com/api/public/v1.0/groups?pretty=true"

次のサンプルPOSTリクエストは、リクエスト本文を受け取り、組織内に MyProject という名前のプロジェクトを作成します。

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --include \
     --request POST "https://cloud.mongodb.com/api/public/v1.0/groups?pretty=true" \
     --data '
       {
         "name": "MyProject",
         "orgId": "deffb2031b938da53f16d714"
       }'

サービスアカウントを使用してAPIリクエストを行うには、サービスアカウントを使用してアクセストークンを生成し、そのアクセストークンをリクエストで使用します。

サービスアカウントのクライアントシークレットを検索します。

サービスアカウントの作成直後に保存した、 mdb_sa_sk_で始まるクライアントシークレットを見つけます。クライアントシークレットを表示できるのは、このときだけです。クライアントシークレットを保存しなかった場合は、新しいクライアントシークレットを生成する必要があります。

base 64 はクライアントIDとシークレットをエンコードします。

例えば例の場合は、次を実行します。

echo -n {CLIENT-ID}:{CLIENT-SECRET} | base64

アクセストークンをリクエストします。

次の例の {BASE64-AUTH} を前のステップの出力に置き換え、実行します。

1 curl --request POST \
2      --url https://cloud.mongodb.com/api/oauth/token \
3      --header 'accept: application/json' \
4      --header 'cache-control: no-cache' \
5      --header 'authorization: Basic {BASE64-AUTH}' \
6      --header 'content-type: application/x-www-form-urlencoded' \
7      --data 'grant_type=client_credentials'

{"access_token":"eyJhbGciOiJFUzUxMiIsInR5cCI6IkpXVCIsImtpZCI6ImYyZjE2YmE4LTkwYjUtNDRlZS1iMWYLTRkNWE2OTllYzVhNyJ9eyJpc3MiOiJodHRwczovL2Nsb3VkLWRldi5tb25nb2RiLmNvbSIsImF1ZCI6ImFwaTovL2FkbWluIiwic3ViIjoibWRi3NhX2lkXzY2MjgxYmM2MDNhNzFhNDMwYjkwNmVmNyIsImNpZCI6Im1kYl9zYV9pZF82NjI4MWJjNjAzYTcxYTQzMGI5MZlZjciLCJhY3RvcklkIjoibWRiX3NhX2lkXzY2MjgxYmM2MDNhNzFhNDMwYjkwNmVmNyIsImlhdCI6MTcxMzkwNTM1OSiZXhwIjoxNzEzOTA4OTU5LCJqdGkiOiI4ZTg1MTM3YS0wZGU1LTQ0N2YtYTA0OS1hMmVmNTIwZGJhNTIifQAZSFvhcjwVcJYmvW6E_K5UnDmeiX2sJgL27vo5ElzeBuPawRciKkn6ervZ6IpUTx2HHllGgAAMmhaP9B66NywhfjAXC67X9KcOzm81DTtvDjLrFeRSc_3vFmeGvfUKKXljEdWBnbmwCwtBlO5SJuBxb1V5swAl-Sbq9Ymo4NbyepSnF""expires_in":3600,"token_type":"Bearer"}%

重要

アクセストークンは 1 時間（ 3600 秒）有効です。アクセストークンを更新することはできません。このアクセストークンの有効期限が切れたら、この手順を繰り返して新しいアクセストークンを生成します。

API呼び出し。

次の例の {ACCESS-TOKEN} を前のステップの出力に置き換えます。例、 --header 'Authorization: Bearer eyJ...pSnF' \ 。

次のサンプルGETリクエストは、現在のユーザーのすべてのプロジェクトを返します。

curl --request GET \
      --url https://cloud.mongodb.com/api/public/v1.0/groups \
      --header 'Authorization: Bearer {ACCESS-TOKEN}' \
      --header 'Accept: application/json' \

次のサンプルPOSTリクエストは、リクエスト本文を受け取り、組織内に MyProject という名前のプロジェクトを作成します。

curl --header 'Authorization: Bearer {ACCESS-TOKEN}' \
     --header 'Content-Type: application/json' \
     --header 'Accept: application/json' \
     --include \
     --request POST 'https://cloud.mongodb.com/api/public/v1.0/groups' \
     --data '
       {
         "name": "MyProject",
         "orgId": "5a0a1e7e0f2912c554080adc"
       }'

戻る

API アクセスの設定

Cloud Manager Administration API チュートリアル

1	curl --request POST \
2	--url https://cloud.mongodb.com/api/oauth/token \
3	--header 'accept: application/json' \
4	--header 'cache-control: no-cache' \
5	--header 'authorization: Basic {BASE64-AUTH}' \
6	--header 'content-type: application/x-www-form-urlencoded' \
7	--data 'grant_type=client_credentials'

プログラムによる組織へのアクセスを管理

注意

必要な権限

組織へのプログラムによるアクセスの付与

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、{0.css-h15tq0{font-style:normal;font-weight:700;}Organization Settings ページにGoします。

Organization Access Managerページに移動します。

[0}Add newApplicationAPI Key をクリックします。

API Key Informationフォームを完了します。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Next

この API キーのアクセス リスト値を追加します。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Save

警告

このページを終了する前に秘密キーをコピーする

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Organization Settings ページにGoします。

Organization Access Managerページに移動します。

[0}Add newApplicationService Account をクリックします。

サービス アカウント情報を入力します。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Create

をコピーして保存してください。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\"Client Secret \">

警告

API Access List Entryを追加します。

組織へのプログラムによるアクセスの表示

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Organization Settings ページにGoします。

Organization Access Managerページに移動します。

[]Applications タブをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">API Keys

View Detailsに移動します。

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Organization Settings ページにGoします。

Organization Access Managerページに移動します。

[]Applications タブをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Service Accounts

組織へのプログラムによるアクセスを更新

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Organization Settings ページにGoします。

Organization Access Managerページに移動します。

[]Applications タブをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">API Keys

編集する API キーを選択します。

API Key Informationフォームを完了します。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Next

この API キーのアクセス リスト値を追加します。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Save

警告

このページを終了する前に秘密キーをコピーする

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Organization Settings ページにGoします。

Organization Access Managerページに移動します。

[]Applications タブをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Service Accounts

サービス アカウントの名前をクリックします。

Service Account Infoを編集します。

新しいクライアントシークレットを生成します。

Organization Permissionsを編集します。

重要

API Access Listを編集します。

組織へのプログラムによるアクセスを取り消す

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Organization Settings ページにGoします。

Organization Access Managerページに移動します。

[]Applications タブをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">API Keys

API キーを削除します。

注意

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Organization Settings ページにGoします。

Organization Access Managerページに移動します。

[]Applications タブをクリックします。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Service Accounts

サービス アカウントを削除します。

プロジェクトへのプログラムによるアクセスを管理

注意

必要な権限

プロジェクトへのプログラムによるアクセスの付与

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Project Access Manager ページにGoします。

[0}Create ApplicationAPI Key をクリックします。

API Key Informationフォームを完了します。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Next

この API キーのアクセス リスト値を追加します。

をクリックします。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Save

警告

このページを終了する前に秘密キーをコピーする

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Project Access Manager ページにGoします。

[0}Create ApplicationService Account をクリックします。

サービス アカウント情報を入力します。

MongoDB Cloud ManagerGoMongoDB Cloud Managerで、{0Organization Settings ページにGoします。

この API キーのアクセスリスト値を追加します。

サービスアカウント情報を入力します。

この API キーのアクセスリスト値を追加します。

サービスアカウントの名前をクリックします。

サービスアカウントを削除します。

この API キーのアクセスリスト値を追加します。

サービスアカウント情報を入力します。

この API キーのアクセスリスト値を追加します。

サービスアカウントの名前をクリックします。

サービスアカウントを削除します。

サービスアカウントのクライアントシークレットを検索します。

アクセストークンをリクエストします。