配置角色继承

为工作区内的子角色添加或移除父角色,并通过继承关系图确认权限传递方向。

任务流程

工作区 IAM 句柄
    │
    ▼
1. 读取子角色与父角色当前的生命周期版本
    │
    ▼
2. 提交添加(或移除)父角色请求
    │
    ▼
3. 读取角色继承关系图 ──▶ 确认有向边(子角色 -> 父角色)

准备

  1. 已完成 使用 SDK 中的服务地址、个人访问令牌与工作区配置。

  2. 当前身份具备目标工作区的角色管理权限。

  3. 确定子角色 ID 与父角色 ID;可按 管理角色与对象权限 列出工作区角色目录获取。

  4. 为本次变更生成唯一请求标识;网络超时等结果未知场景下请复用原请求标识复核状态。

添加继承关系

先分别读取子角色与父角色当前的权限视图以取得期望生命周期版本,再提交添加父角色请求,最后读取继承关系图确认新增边。继承关系边由子角色指向父角色,服务端会自动校验角色状态并拦截环路依赖。

import os
import uuid

import moi_product_sdk as sdk

client = sdk.new_with_personal_access_token(
    os.environ["PRODUCT_API_BASE_URL"],
    os.environ["PRODUCT_API_KEY"],
)
iam = client.iam(os.environ["WORKSPACE_ID"])
child_id = os.environ["CHILD_ROLE_ID"]
parent_id = os.environ["PARENT_ROLE_ID"]

child = iam.role_permission_view(child_id)
parent = iam.role_permission_view(parent_id)

added = iam.add_role_inheritance(
    child_id,
    sdk.IAMRoleInheritanceMutationRequest(
        parent_role_id=parent_id,
        expected_child_lifecycle_version=child.expected_role_lifecycle_version,
        expected_parent_lifecycle_version=parent.expected_role_lifecycle_version,
        request_id=str(uuid.uuid4()),
    ),
)
print("Added edge:", added.child_role_id, "->", added.parent_role_id)

graph = iam.role_inheritance_graph(child_id)
for edge in graph.edges:
    print(edge)
package main

import (
	"context"
	"fmt"
	"os"
	"time"

	sdk "github.com/matrixorigin/matrixflow/sdk/go-sdk"
)

func main() {
	ctx := context.Background()
	client, err := sdk.NewWithPersonalAccessToken(
		os.Getenv("PRODUCT_API_BASE_URL"),
		os.Getenv("PRODUCT_API_KEY"),
	)
	if err != nil {
		panic(err)
	}
	iam := client.IAM(os.Getenv("WORKSPACE_ID"))
	childID := os.Getenv("CHILD_ROLE_ID")
	parentID := os.Getenv("PARENT_ROLE_ID")

	child, err := iam.RolePermissionView(ctx, childID)
	if err != nil {
		panic(err)
	}
	parent, err := iam.RolePermissionView(ctx, parentID)
	if err != nil {
		panic(err)
	}

	added, err := iam.AddRoleInheritance(ctx, childID, &sdk.IAMRoleInheritanceMutationRequest{
		ParentRoleId:                   parentID,
		ExpectedChildLifecycleVersion:  child.GetExpectedRoleLifecycleVersion(),
		ExpectedParentLifecycleVersion: parent.GetExpectedRoleLifecycleVersion(),
		RequestId:                      fmt.Sprintf("role-inherit-add-%d", time.Now().UnixNano()),
	})
	if err != nil {
		panic(err)
	}
	fmt.Println("Added edge:", added.GetChildRoleId(), "->", added.GetParentRoleId())

	graph, err := iam.RoleInheritanceGraph(ctx, childID)
	if err != nil {
		panic(err)
	}
	for _, edge := range graph.GetEdges() {
		fmt.Println(edge)
	}
}

移除继承关系

需要解除已有的父子角色继承时,重新读取两个角色的最新生命周期版本并提交移除请求,随后回查继承关系图确认该边已移除。若返回版本冲突,请重新读取角色版本并核对并发变更后再提交。

child = iam.role_permission_view(child_id)
parent = iam.role_permission_view(parent_id)

removed = iam.remove_role_inheritance(
    child_id,
    sdk.IAMRoleInheritanceMutationRequest(
        parent_role_id=parent_id,
        expected_child_lifecycle_version=child.expected_role_lifecycle_version,
        expected_parent_lifecycle_version=parent.expected_role_lifecycle_version,
        request_id=str(uuid.uuid4()),
    ),
)
print("Removed edge:", removed.child_role_id, "->", removed.parent_role_id)
child, err = iam.RolePermissionView(ctx, childID)
if err != nil {
	panic(err)
}
parent, err = iam.RolePermissionView(ctx, parentID)
if err != nil {
	panic(err)
}

removed, err := iam.RemoveRoleInheritance(ctx, childID, &sdk.IAMRoleInheritanceMutationRequest{
	ParentRoleId:                   parentID,
	ExpectedChildLifecycleVersion:  child.GetExpectedRoleLifecycleVersion(),
	ExpectedParentLifecycleVersion: parent.GetExpectedRoleLifecycleVersion(),
	RequestId:                      fmt.Sprintf("role-inherit-rm-%d", time.Now().UnixNano()),
})
if err != nil {
	panic(err)
}
fmt.Println("Removed edge:", removed.GetChildRoleId(), "->", removed.GetParentRoleId())

下一步

最后更新于