For AI agents: the complete documentation index is available at https://docs.dataplatform.ovh.net/ja/llms.txt, the full documentation bundle is available at https://docs.dataplatform.ovh.net/ja/llms-full.txt, and this page is available as Markdown at https://docs.dataplatform.ovh.net/ja/iam-service-accounts.md.
  • 🇯🇵 日本語
  • APIおよび自動化アクセス用のサービスアカウントを作成する

    サービスアカウントは、API消費者、リモートサーバーアクセス、スクリプト、またはその他の自動化エンティティによって使用される特殊な種類のアカウントです

    目的

    A service accountは、API消費者、リモートサーバーアクセス、スクリプト、またはその他の自動化されたエンティティによって使用される特殊な種類のアカウントです。物理的な人ではなく、です。

    Data Platform では、サービスアカウントは一般的に2つの理由で使用されます:

    • 外部的に、APIおよびシークレットキーを使用して、プロジェクトにアクセスする必要があるリモートエンティティを認証するため
    • 内部的に、プロジェクトのジョブを認証するため。例えば、サービスアカウントをData Processing Engineワークフローにアタッチすることができます。実行時に、ジョブはサービスアカウントとして認証できます。サービスアカウントのロールは、ジョブがアクセスできるリソースを制御します。

    彼らは、Identity Access ManagerのService Accountsタブにあります。Data Platformでは、各サービスアカウントは技術名で識別され、その名前はユニークである必要があります。

    Info

    Service Accounts は Project IAM にのみ存在します。

    プロジェクトサービスアカウントの管理

    A サービスアカウントには、プロジェクトIAM ロールが付与できます。これにより、関連するエンティティ(外部エンティティまたは内部ジョブ)がリソースにアクセスできます。サービスアカウントは、関連するエンティティのアイデンティティとして使用され、サービスアカウントのロールは、エンティティがアクセスできるリソースを制御します。

    Info

    これにより、サービスアカウントを使用して、Data Processing EngineのCRONトリガージョブや、Data Platform上のデータにアクセスする必要があるリモートAPIのアクセスレベルを制限することができます。

    サービスアカウントには2種類あります:

    • デフォルトのData Platform由来のサービスアカウント: これはプロジェクトの作成時に生成され、基本的なサービスがすぐに実行できるようになります。例えば、デフォルトのプロジェクトサービスアカウントなどです。
    • ユーザー管理サービスアカウント: これはData Platformのユーザーによって作成されます。

    デフォルトサービスアカウント

    デフォルトプロジェクトサービスアカウント は、プロジェクトの作成時に自動的に生成される、Data Platform由来のサービスアカウントです。このアカウントは、Data Processing Engine内のすべてのジョブで、認証とアクセス制御にデフォルトで使用されます。このサービスアカウントは削除できません。

    プロジェクト内のユーザーは、常にData Processing Engineでこのサービスアカウントを代行することができます。

    Warning

    このサービスアカウントのインパーソネーションを、プロジェクトのIAMで認証されたユーザーによって制限することはできません。可能性のある特権昇格を避けるためには、このデフォルトのサービスアカウントに付与された権限を下げる必要があります。

    デフォルトでは、プロジェクトの作成時に、デフォルトプロジェクトサービスアカウント はプロジェクトで 管理者アクセス権 を持っています。

    新しいサービスアカウントを作成

    プロジェクトにサービスアカウントを追加するには、新しいサービスアカウントをクリックしてください。

    iam

    サービスアカウントの名前とメールアドレスを入力してください。

    Warning

    このメールアドレスは、リモートエンティティの認証に必要なAPIおよびシークレットキーを送信するために使用されます。

    iam
    Info

    デフォルトでは、新しいサービスアカウントにはアクセス権限が付与されていません。グループに所属させるか、グループに所属させるか、ロールを直接割り当てる必要があります。

    サービスアカウントをグループに追加する サービスアカウントにロールを割り当てる

    ジョブ内でサービスアカウントを内部的に使用

    すべての Data Processing Engine のジョブは、ワークロードの認証とアクセス制御のためにサービスアカウントを使用します。そのため、このジョブを実行できるユーザーは、実行されたワークロードを通じてサービスアカウントを偽装し、そのアクセス権を取得できることになります。

    Info

    現在、ジョブのサービスアカウントは変更できません。この機能は間もなくリリースされます!

    デフォルトでは、ジョブは デフォルトプロジェクトサービスアカウント を使用するように設定されています。このサービスアカウントの偽装をユーザーが制限することはできませんので、一部のユーザーがすべてにアクセスできない場合に特権昇格が発生する可能性を避けるため、このサービスアカウントから不要な権限を削除するようにしてください。

    そのためには、デフォルトプロジェクトサービスアカウントページを開き、このサービスアカウントにバインドされているすべてのグループとロールを削除し、サービスアカウントに必要な基本的なロール/グループを追加して保存します。Data Processing Engineジョブがエラーなく実行できるための基本的な権限は、以下の通りです:

    • Data Manager | * | Read
    • Data Processing Engine | * | Read
      • Data Processing Engine | * | Write はオプションであり、ジョブ実行の終了時にメタデータ(テーブルの行数など)を更新したい場合にのみ必要です
    • Data Store | Bucket | Read、バケット dpe に対する 条件 を付けてください

    サービスアカウントを外部で使用

    外部からData Platform内の特定のジョブ(ワークフローの起動など)をトリガーする必要がある場合は、認証に使用するAPIとシークレットキーを生成する必要があります。

    サービスアカウント用のAPI & シークレットキーを生成する

    さらに進む

    トレーニングや技術的なサポートが必要な場合は、営業担当者にお問い合わせください。または、Professional Servicesページをご覧になり、見積もりをリクエストして、当社の専門家がプロジェクトを分析していただくこともできます。

    データプラットフォームを構築するチームに直接質問したり、フィードバックを送ったり、交流したりするには、専用のDiscordチャネルをご利用ください。

    サポートが必要な場合は、ヘルプセンターでリクエストを作成してください。

    当社のユーザーコミュニティに参加してください。