役割を使用したアクセスの制御

• AdministratorRolesApi: ロールの作成、変更、削除、検索、説明、および一覧表示。
• Role: 役割を表し、役割のプロパティへのアクセスを提供します。
• Rightsクラス: Workload Securityリソースへのアクセス権を表すいくつかのクラス。例えば、ComputerRightsはコンピュータとの対話の権限を定義し、ScheduledTaskRightsはスケジュールされたタスクとの対話の権限を定義します。

1. Roleオブジェクトを作成し、プロパティを構成します:
   • 役割を識別するための名前を入力し、必要に応じて説明を入力します。
   • 必要に応じて、役割がアクセスできるコンピュータとポリシーを指定します。
   • 必要に応じて、コンピュータ上で役割が実行できるタスクと、アクセスできるポリシーを指定する権限オブジェクトを追加します。
2. AdministratorsRoleApiオブジェクトを作成し、それを使用してWorkload Securityでロールを作成または変更します。

• allComputersおよびallPolicies項目は、すべてのコンピューターとポリシーへのアクセスを制御します。いずれかがfalseの場合、computerIDsおよびpolicyIDs項目にはアクセス可能なコンピューターとポリシーのIDが含まれます
• rights項目とその子孫は、Workload Securityリソースへのアクセス権を定義するさまざまな権利クラスに対応しています。この例を簡潔にするために、権利項目の深いレベルは表示されていません。

{
    "name": "Auditor",
    "description": "",
    "urn": "urn:tmds:identity:us-east-ds-1:41342:role/Auditor",
    "immutable": false,
    "canOnlyManipulateUsersWithEqualOrLesserRights": false,
    "allComputers": true,
    "allPolicies": true,
    "allowUserInterface": true,
    "allowWebService": true,
    "rights": {
        "platformRights": {...},
        "antiMalwareRights": {...},
        "webReputationRights": {...},
        "firewallRights": {...},
        "intrusionPreventionRights": {...},
        "integrityMonitoringRights": {...},
        "logInspectionRights": {...},
        "applicationControlRights": {...},
        "hostedServiceRights": {...}
    },
    "ID": 2
}

run_reports_role = api.Role()
run_reports_role.name = "Computer Status and Properties"

computer_rights = api.ComputerRights()
computer_rights.can_edit_computer_properties = True

platform_rights = api.PlatformRights() 
platform_rights.computer_rights = computer_rights

rights = api.Rights()
rights.platform_rights = platform_rights

run_reports_role.rights = rights

admin_roles_api = api.AdministratorRolesApi(api.ApiClient(configuration))
new_role = admin_roles_api.create_administrator_role(run_reports_role, api_version)

# Create the Role object
run_reports_role = api.Role()
run_reports_role.name = "Computer Status and Properties"

# No need for access to policies
run_reports_role.all_policies = False

# Add rights to edit computer properties
computer_rights = api.ComputerRights()
computer_rights.can_edit_computer_properties = True

platform_rights = api.PlatformRights()
platform_rights.computer_rights = computer_rights

rights = api.Rights()
rights.platform_rights = platform_rights

# Add the rights to the role
run_reports_role.rights = rights

# Create the role on Workload Security
admin_roles_api = api.AdministratorRolesApi(api.ApiClient(configuration))
new_role = admin_roles_api.create_administrator_role(run_reports_role, api_version)

return new_role.id