API 標準および多言語対応の SDK
本製品 (Sddp/2019-01-03) の API は、RPC 標準に準拠した OpenAPI 仕様を採用しています。Alibaba Cloud には主要なプログラミング言語に対応した SDK が用意され、リクエスト署名のような手間がかかる手順を省略できます。そのため、開発者は HTTP 通信の詳細を意識することなく、各言語の構文で API を呼び出すことが可能になります。
カスタム署名
署名のカスタマイズが必要な場合、「署名メカニズム」を参照してリクエストに手動で署名できます。手動署名プロセスは非常に煩雑で、通常はおよそ 5 営業日かかります。詳細については、DingTalk サポート窓口 (グループチャット ID:147535001692) までお問い合わせください。
はじめに
Alibaba Cloud アカウント (root ユーザー) は最高レベルの管理権限を持ち、その AccessKey ペアが悪用されると、関連するすべてのリソースが不正にアクセスされ、重大なセキュリティリスクを引き起こす可能性があります。そのため、必要な場合以外は、Alibaba Cloud アカウントを使用しないでください。その代わりに、API のみでのアクセスを許可された Resource Access Management (RAM) ユーザーを作成し、RAM ポリシーを設定することで、最小権限の原則 (PoLP) を徹底してください。
API セキュリティを確保するには、以下を作成し、設定する必要があります。
RAM ユーザー
RAM ユーザー用の AccessKey ペア
データ監査
|
API |
タイトル |
説明 |
| DescribeAuditLogs | DescribeAuditLogs | 監査アラートログのリストを取得します。 |
サービスリンクロール
|
API |
タイトル |
説明 |
| CreateSlrRole | CreateSlrRole | CreateSlrRole を呼び出して、Data Security Center (DSC) 用のサービスリンクロールを作成します。このロールは、DSC がご利用のクラウドリソースにアクセスすることを許可します。 |
認可
|
API |
タイトル |
説明 |
| DeleteDataLimit | DeleteDataLimit | この操作を呼び出して、データベース、インスタンス、バケットなどのデータ資産の権限付与を取り消します。 |
| DescribeDataLimits | DescribeDataLimits | 権限が付与されたインスタンス、データベース、バケットのデータ資産リストを照会します。 |
| ModifyDataLimit | ModifyDataLimit | ModifyDataLimit を呼び出して、Data Security Center (DSC) の接続権限付与の設定項目を変更できます。 |
| DescribeDataLimitDetail | DescribeDataLimitDetail | Data Security Center (DSC) へのアクセスを許可したデータ資産(例:MaxCompute プロジェクト、ApsaraDB RDS データベース、Object Storage Service (OSS) バケット)の詳細情報をクエリします。 |
| CreateDataLimit | CreateDataLimit | CreateDataLimit 操作を呼び出して、データベース、プロジェクト、バケットをスキャンする権限を付与できます。 |
| DescribeDataLimitSet | DescribeDataLimitSet | DescribeDataLimitSet 操作を呼び出して、非構造化資産の権限付与リスト、または Data Security Center でサポートされているリージョンのリストをクエリします。 |
| DescribeInstanceSources | DescribeInstanceSources | データ資産のリストを照会します。 |
| DescribeParentInstance | DescribeParentInstance | この操作を呼び出して、データ資産およびその権限付与ステータスを照会します。 |
検出設定
|
API |
タイトル |
説明 |
| ScanOssObjectV1 | ScanOssObjectV1 | ScanOssObjectV1 操作は、指定されたオブジェクト内のセンシティブデータを検出するためのスキャンタスクを作成します。 |
| CreateScanTask | CreateScanTask | CreateScanTask 操作を呼び出して、承認済み資産内の機密データを検出するためのカスタムスキャンタスクを作成できます。 |
| ModifyDefaultLevel | ModifyDefaultLevel | 機密データの脅威レベルを定義するルールを変更します。これには、未識別データのデフォルトの脅威レベルと、機密として分類されたデータの脅威レベルが含まれます。 |
| ModifyRuleStatus | ModifyRuleStatus | センシティブデータ検出ルールを有効または無効にします。 |
| ModifyRule | ModifyRule | Data Security Center (DSC) のカスタム機密データ検出ルールを変更します。 |
| DeleteRule | DeleteRule | カスタムの機密データ検出ルールを削除します。 |
| CreateRule | CreateRule | CreateRule を呼び出して、カスタム機密データ検出ルールを作成します。 |
データ検出
|
API |
タイトル |
説明 |
| DescribeRules | DescribeRules | 機密データ検出ルールの一覧を照会します。 |
| DescribeRiskLevels | DescribeRiskLevels | DescribeRiskLevels 操作を呼び出して、機密データのリスクレベル一覧を取得します。 |
| DescribeDataAssets | DescribeDataAssets | Data Security Center (DSC) の概要ページでデータ資産を検索します。 |
| DescribeInstances | DescribeInstances | 承認済みの MaxCompute、RDS、および OSS データ資産インスタンスのリストを取得します。 |
| DescribeTables | DescribeTables | Data Security Center がアクセス権限を持つデータ資産(例:MaxCompute、RDS)内のテーブルを照会します。 |
| DescribeColumns | DescribeColumns | Data Security Center に接続が認可されている MaxCompute や RDS などのデータ資産テーブルの列データをクエリするには、DescribeColumns API を呼び出します。 |
| DescribeColumnsV2 | Query Data in Columns of Data Assets V2 | DescribeColumnsV2 操作は、Data Security Center で承認されている、MaxCompute や RDS などのデータ資産テーブルの列にあるデータをクエリします。 |
| DescribeOssObjects | DescribeOssObjects | この操作を呼び出して、承認済み OSS オブジェクトのリストをクエリします。 |
| DescribeOssObjectDetail | DescribeOssObjectDetail | このオペレーションを呼び出して、Data Security Center の承認を受けた単一の OSS オブジェクトの詳細をクエリします。 |
| DescribeOssObjectDetailV2 | DescribeOssObjectDetailV2 | Data Security Center で承認された OSS オブジェクトの詳細情報を取得します。 |
| DescribePackages | DescribePackages | この API を呼び出すと、スキャン用に承認された MaxCompute パッケージに関する情報をクエリできます。この情報には、パッケージ名、所有者のアカウント、およびリスクレベルが含まれます。 |
| DescribeCategoryTemplateList | Query Industry Template List | この操作を呼び出して、業界固有のテンプレートのリストをクエリできます。 |
| DescribeCategoryTemplateRuleList | DescribeCategoryTemplateRuleList | データ分類テンプレート内のルールをページ分割されたリストでクエリします。 |
| DescribeTemplateAllRules | Query All Models List of Industry Templates | この操作を呼び出して、業種テンプレート内のすべてのモデルをクエリできます。 |
| DescribeDocTypes | DescribeDocTypes | Object Storage Service (OSS) でサポートされているファイルタイプのリストを照会します。 |
| DescribeDataObjects | Query Data Object List | テーブルおよびファイルのデータ検出結果をクエリします。 |
| DescribeDataObjectColumnDetail | Query Data Object Column Details | データテーブル内のカラムの検出結果を照会します。 |
| DescribeDataObjectColumnDetailV2 | Query Data Object Column Details V2 | データテーブルのカラムの検出結果をクエリします。 |
セキュリティ設定
|
API |
タイトル |
説明 |
| CreateConfig | CreateConfig | アラートの共通設定項目の構成を変更します。 |
| DescribeConfigs | DescribeConfigs | 異常アラートの共通設定項目を照会します。 |
| ModifyReportTaskStatus | ModifyReportTaskStatus | ModifyReportTaskStatus 操作を呼び出して、レポートタスクを有効化または無効化できます。 |
| DescribeUserStatus | DescribeUserStatus | `DescribeUserStatus` は、ユーザーアカウントのステータスを照会するために使用します。 |
| DisableUserConfig | DisableUserConfig | DisableUserConfig 操作を呼び出して、ユーザー設定を無効化します。設定が無効化された後、CreateConfig 操作を呼び出して同じ Code パラメーターを指定することで、一般的な異常アラート設定を復元できます。 |
異常アラート
|
API |
タイトル |
説明 |
| ModifyEventTypeStatus | ModifyEventTypeStatus | この操作により、サブタイプに対する異常活動検出が有効になります。 |
| ModifyEventStatus | ModifyEventStatus | 異常なアクティビティを処理します。 |
| DescribeEvents | DescribeEvents | 異常イベントを一覧表示します。 |
| DescribeEventDetail | DescribeEventDetail | この操作を呼び出すと、単一の異常なアクティビティについて、その発生時間、説明、処理ステータスなどの詳細を照会できます。 |
| DescribeEventTypes | DescribeEventTypes | 異常なアクティビティタイプを照会します。 |
データマスキング
|
API |
タイトル |
説明 |
| DescribeDataMaskingTasks | DescribeDataMaskingTasks | DescribeDataMaskingTasks を呼び出して、データマスキングタスクのリストを取得します。 |
| DescribeDataMaskingRunHistory | DescribeDataMaskingRunHistory | DescribeDataMaskingRunHistory を呼び出して、データマスキングタスクの実行履歴を照会できます。 |
| ExecDatamask | ExecDatamask | ExecDatamask 操作を呼び出して、データを動的にマスキングできます。 |
| StopMaskingProcess | StopMaskingProcess | \`StopMaskingProcess` 操作を呼び出して、データマスキングタスクを停止できます。停止したタスクは、その一意のリソース ID を使用して `ManualTriggerMaskingProcess` 操作を呼び出すことで再開できます。 |
| ManualTriggerMaskingProcess | ManualTriggerMaskingProcess | データマスキングタスクをトリガーします。 |
その他
|
API |
タイトル |
説明 |
| DescribeIdentifyTaskStatus | Get Identification Task Status | タスク ID に基づいて検出タスクの完了ステータスを取得します。タスク ID は、CreateScanTask または ScanOssObjectV1 API の呼び出しの戻り値にある Id フィールドから取得できます。 |
| MaskOssImage | MaskOssImage | MaskOssImage 操作を使用して、オブジェクトとして保存されている画像をマスキングします。 |
| RestoreOssImage | RestoreOssImage | RestoreOssImage 操作を呼び出して、マスキングされたイメージを復元できます。 |