配置角色继承¶
为工作区内的子角色添加或移除父角色,并通过继承关系图确认权限传递方向。
任务流程¶
工作区 IAM 句柄
│
▼
1. 读取子角色与父角色当前的生命周期版本
│
▼
2. 提交添加(或移除)父角色请求
│
▼
3. 读取角色继承关系图 ──▶ 确认有向边(子角色 -> 父角色)
准备¶
添加继承关系¶
先分别读取子角色与父角色当前的权限视图以取得期望生命周期版本,再提交添加父角色请求,最后读取继承关系图确认新增边。继承关系边由子角色指向父角色,服务端会自动校验角色状态并拦截环路依赖。
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())
下一步¶
最后更新于