SCIM을 사용하여 사용자 및 그룹 관리하기¶

POST scim/v2/Users¶

userName 및 loginName 이 동일한 값에 매핑된 사용자를 생성합니다.

{
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User",
        "urn:ietf:params:scim:schemas:extension:2.0:User"
        ],
    "userName": "test_user_1",
    "password": "test",
    "name": {
        "givenName": "test",
        "familyName": "user"
        },
    "emails": [{
        "value": "test.user@snowflake.com"
        }
    ],
    "displayName": "test user",
    "active": true
}

Copy

userName 및 loginName 이 다른 값에 매핑된 사용자를 생성합니다.

ID 공급자가 Okta인 경우, 이 절차 를 따릅니다.

{
    "active": true,
    "displayName": "test user",
    "emails": [
        {
            "value": "test.user@snowflake.com"
        }
    ],
    "name": {
        "familyName": "test_last_name",
        "givenName": "test_first_name"
    },
    "password": "test_password",
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User",
        "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
    ],
    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
        "snowflakeUserName": "USER5"
    },
    "userName": "USER5"
}

Copy

PATCH scim/v2/Users/{id}¶

userName 및 loginName 이 동일한 값에 매핑된 사용자를 업데이트합니다.

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [{
        "op": "replace",
        "value": {
            "active": false
        }
    }]
}

Copy

userName 및 loginName 이 다른 값에 매핑된 사용자를 업데이트합니다.

ID 공급자가 Okta인 경우, 이 절차 를 따릅니다.

{
    "Operations": [
        {
            "op": "Replace",
            "path": "userName",
            "value": "test_updated_name"
        },
        {
            "op": "Replace",
            "path": "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User.snowflakeUserName",
            "value": "USER5"
        }
    ],
    "schemas": [
        "urn:ietf:params:scim:api:messages:2.0:PatchOp"
    ]
}

Copy

PUT scim/v2/Users/{id}¶

"defaultRole", "defaultSecondaryRoles" 및 "defaultWarehouse" 필드 설정을 포함하여 사용자를 업데이트합니다.

"defaultRole", "defaultSecondaryRoles" 및 "defaultWarehouse" 속성을 지정하려면, Snowflake에서는 반드시 extension 스키마 중 1개를 사용해야 합니다. defaultSecondaryRoles 에 대해 유일하게 가능한 값은 "ALL" 입니다.

참고

Snowflake는 이를 지원하지만, PATCH 작업에 비해 많은 비용이 소요되므로 PUT 작업을 사용할 때는 주의해야 합니다. 대신, PATCH 작업을 사용하십시오.

{
    "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:User",
        "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
        ],
    "userName": "test_user_1",
    "password": "test",
    "name": {
        "givenName": "test",
        "familyName": "user"
        },
    "emails": [{
        "primary": true,
        "value": "test.user@snowflake.com",
        "type": "work"
        }
    ],
    "displayName": "test user",
    "active": true,
    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
        "defaultRole" : "test_role",
        "defaultSecondaryRoles" : "ALL",
        "defaultWarehouse" : "test_warehouse"
    }
}

Copy

POST scim/v2/Groups¶

{
    "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Group"],
    "displayName":"scim_test_group2"
}

Copy

PATCH scim/v2/Groups/{id}¶

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [{
        "op": "replace",
        "value": {
            "displayName": "updated_name"
            }
        },
        {
            "op" : "remove",
            "path": "members[value eq \"user_id_1\"]"
        },
        {
          "op": "add",
          "value": [{
            "value": "user_id_2"
            }]
        }
    ]
}

Copy