Ir para o conteúdo

Esta página foi traduzida automaticamente e pode conter imprecisões. Para relatar um erro de tradução, use o componente de feedback na parte inferior do sumário, à direita da página.

Procurar uma conta de usuário existente no dashboard por ID de recurso

get

/scim/v2/Users/{id}

Use este endpoint para procurar uma conta de usuário do dashboard existente especificando o recurso id retornado pelo método SCIM POST.

See me in Postman

Importante

Esse endpoint exige a integração SCIM personalizada. Se você configurou uma integração de provedor de identidade (IdP) (Okta ou Entra ID), não é possível usar esse endpoint; apenas uma ponte SCIM pode ser configurada por empresa.

Pré-requisitos

Para usar esse endpoint, você precisará de um token SCIM. Você usará a Origin do seu serviço como o cabeçalho X-Request-Origin. Para saber mais, consulte Provisionamento automatizado de usuários.

Limite de frequência

Esse endpoint tem um limite de frequência de 20.000 solicitações por dia, por empresa. Esse limite de frequência é compartilhado com os endpoints /scim/v2/Users/ PUT, GET, DELETE e POST, conforme documentado em Limites de frequência da API.

Parâmetros de caminho

Parâmetro	Obrigatório	Tipo de dados	Descrição
`id`	Obrigatório	String	O ID do recurso do usuário. Esse parâmetro é retornado pelos métodos `POST` `/scim/v2/Users/` ou `GET` `/scim/v2/Users?filter=userName eq "[email protected]"`.

Parâmetros de solicitação

Content-Type: application/json
X-Request-Origin: YOUR-REQUEST-ORIGIN-HERE
Authorization: Bearer YOUR-SCIM-TOKEN-HERE

Nota

Se você receber uma resposta 401, confirme que está usando um token SCIM (e não uma chave da API REST), que o X-Request-Origin corresponde à Origin do seu serviço e que seu endereço IP está na lista de permissões do SCIM. Para saber mais, consulte Provisionamento automatizado de usuários.

Exemplo de solicitação

curl --location --request GET 'https://rest.iad-01.braze.com/scim/v2/Users/dfa245b7-24195aec-887bb3ad-602b3340' \
--header 'Content-Type: application/json' \
--header 'X-Request-Origin: YOUR-REQUEST-ORIGIN-HERE' \
--header 'Authorization: Bearer YOUR-SCIM-TOKEN-HERE' \

Resposta

{
    "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
    "id": "dfa245b7-24195aec-887bb3ad-602b3340",
    "userName": "[email protected]",
    "name": {
        "givenName": "Test",
        "familyName": "User"
    },
    "department": "finance",
    "lastSignInAt": "2024 Nov 11, 4:20 PM",
    "createdAt": "2024 Nov 11, 4:20 PM",
    "permissions": {
        "companyPermissions": ["manage_company_settings"],
        "roles": [
            {
                "roleName": "Another Test Role",
                "roleId": "b2c3d4e5-f6a7-4b1c-9d2e-4f5a6b7c8d9e",
                "appGroup": [
                    {
                        "appGroupId": "c3d4e5f6-a7b8-4c1d-8e2f-5a6b7c8d9e0f",
                        "appGroupName": "Production Workspace",
                        "appGroupPermissionSets": [
                            {
                                "appGroupPermissionSetName": "A Permission Set",
                                "appGroupPermissionSetId": "d4e5f6a7-b8c9-4d1e-9f2a-6b7c8d9e0f1a",
                                "permissions": ["view_campaigns","edit_campaigns","view_content_blocks"]
                            }
                        ]
                    }
                ]
            }
        ],
        "appGroup": [
            {
                "appGroupId": "a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d",
                "appGroupName": "Test Workspace",
                "appGroupPermissions": ["view_campaigns","view_canvases"],
                "team": [
                    {
                         "teamId": "a1b2c3d4-e5f6-4a1b-8c2d-3e4f5a6b7c8d",
                         "teamName": "Test Team",
                         "teamPermissions": ["edit_campaigns","launch_campaigns","edit_canvases","launch_canvases"]
                    }
                ]
            }
        ]
    }
}

Parâmetros de resposta

Parâmetro	Tipo de dados	Descrição
`schemas`	Matriz de strings	Esquema de usuário SCIM.
`id`	String	O ID do recurso do usuário.
`userName`	String	O endereço de e-mail do usuário.
`name`	Objeto	Contém `givenName` e `familyName`.
`department`	String	O departamento do usuário, se definido.
`createdAt`	String	Quando a conta do usuário foi criada. Retorna `N/A` quando não definido; caso contrário, formatado como `YYYY Mon DD, H:MM AM/PM`.
`lastSignInAt`	String	Quando o usuário fez login pela última vez. Retorna `N/A` se o usuário nunca fez login; caso contrário, formatado como `YYYY Mon DD, H:MM AM/PM`.
`permissions`	Objeto	Permissões de empresa, espaço de trabalho, equipe e função do usuário. Consulte o objeto de permissões.

Estados de erro

Se nenhum usuário existir para o id de recurso fornecido, o endpoint retornará:

HTTP/1.1 404 Not Found
Content-Type: application/json

{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:Error"],
  "status": 404,
  "detail": "Resource not found"
}

New Stuff!