Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo demonstra as etapas para configurar o provisionamento da ID do Microsoft Entra para o SAP Cloud Identity Services. A meta é configurar o Microsoft Entra ID para provisionar e desprovisionar automaticamente os usuários para o SAP Cloud Identity Services, para que esses usuários possam se autenticar no SAP Cloud Identity Services e ter acesso a outras cargas de trabalho SAP. O SAP Cloud Identity Services dá suporte ao provisionamento de seu diretório de identidade local para outros aplicativos SAP como sistemas de destino.
Observação
Este artigo descreve um conector integrado no serviço de provisionamento de usuários do Microsoft Entra. Para obter detalhes importantes sobre o que esse serviço faz, como ele funciona e perguntas frequentes, confira Automatizar o provisionamento e o desprovisionamento de usuários para aplicativos SaaS com o Microsoft Entra ID. O SAP Cloud Identity Services também tem seu próprio conector separado para ler usuários e grupos do Microsoft Entra ID. Para obter mais informações, confira SAP Cloud Identity Services – Provisionamento de identidade – Microsoft Entra ID como um sistema de origem.
Observação
Uma nova versão do conector do SAP Cloud Identity Services está em disponibilidade geral e agora é o padrão para a listagem do SAP Cloud Identity Services na galeria de aplicativos do Microsoft Entra. Esta versão atual do conector apresenta as seguintes alterações:
- Atualizado para o padrão SCIM 2.0
- Suporte para provisionamento e desprovisionamento de grupo para o SAP Cloud Identity Services
- Suporte para atributos de extensão personalizados
- Suporte para a concessão de Credenciais de Cliente do OAuth 2.0
Importante
Se estiver integrando com o SAP IAG, mapeie o Microsoft Entra ObjectId para o nome de usuário selecionando EDITAR na linha de nome de usuário e defina os atributos de origem e de destino como:
- Atributo de origem: objectId
- Atributo de destino: userName
Pré-requisitos
O cenário descrito neste artigo pressupõe que você já tenha os seguintes pré-requisitos:
- Uma conta de usuário do Microsoft Entra com uma assinatura ativa. Se você ainda não tem uma conta, é possível criar uma conta gratuita.
- Uma das seguintes funções:
- Um locatário do SAP Cloud Identity Services
- Uma conta de usuário no SAP Cloud Identity Services com permissões de administrador.
- Uma licença do Microsoft Entra ID P1 é necessária para usar recursos de provisionamento de grupo.
Observação
Esta integração também está disponível para uso no ambiente de nuvem do Microsoft Entra para o Governo dos EUA. Você pode encontrar esse aplicativo na Galeria de Aplicativos de Nuvem do Microsoft Entra US Government e configurá-lo da mesma maneira que você faz no ambiente de nuvem pública.
Se você ainda não tiver usuários no Microsoft Entra ID, comece com o artigo planejando a implantação do Microsoft Entra para o provisionamento de usuários com aplicativos de origem e destino do SAP. Esse artigo ilustra como conectar o Microsoft Entra com fontes autoritativas para a lista de trabalhadores em uma organização, como o SAP SuccessFactors. Ele também mostra como usar o Microsoft Entra para configurar identidades para esses trabalhos, para que eles possam entrar em um ou mais aplicativos SAP, como SAP ECC ou SAP S/4HANA.
Se você estiver configurando o provisionamento no SAP Cloud Identity Services em um ambiente de produção, onde está controlando o acesso a cargas de trabalho SAP usando a Governança de ID do Microsoft Entra, examine os pré-requisitos para configurar a ID do Microsoft Entra para governança de identidade antes de continuar.
Configurar o SAP Cloud Identity Services para provisionamento
Neste artigo, você adicionará um sistema de administração no SAP Cloud Identity Services e, em seguida, configurará o Microsoft Entra.
Entre no console de administrador do SAP Cloud Identity Services,
https://<tenantID>.accounts.ondemand.com/adminouhttps://<tenantID>.trial-accounts.ondemand.com/adminse for uma avaliação. Acesse Usuários e Autorizações > Administradores.
Pressione o botão +Adicionar no painel esquerdo para adicionar um novo administrador à lista. Escolha Adicionar Sistema e digite o nome do sistema.
Observação
A identidade do administrador no SAP Cloud Identity Services deve ser do tipo Sistema. Um usuário administrador não pode se autenticar na API do SAP SCIM ao provisionar. O SAP Cloud Identity Services não permite que o nome de um sistema seja alterado após sua criação.
Em Configurar Autorizações, alterne o botão de alternância para ativar as opções Gerenciar Usuários. Em seguida, selecione Salvar para criar o sistema.
Depois que o sistema de administrador for criado, adicione um novo segredo a esse sistema.
Copie a ID do cliente e o segredo do cliente gerados pelo SAP. Esses valores são inseridos nos campos Nome de Usuário administrador e Senha de Administrador, respectivamente. Isso é feito na guia Provisionamento do aplicativo SAP Cloud Identity Services, que você configurou na próxima seção.
O SAP Cloud Identity Services pode ter mapeamentos para um ou mais aplicativos SAP como sistemas de destino. Verifique se existem atributos nos usuários que esses aplicativos SAP exigem para serem provisionados por meio dos SAP Cloud Identity Services. Este artigo pressupõe que o SAP Cloud Identity Services e os sistemas de destino downstream exigem dois atributos
userNameeemails[type eq "work"].value. Se seus sistemas de destino SAP exigirem outros atributos e eles não fizerem parte do esquema de usuário do Microsoft Entra ID, talvez seja necessário configurar atributos de extensão de sincronização.
Adicionar o SAP Cloud Identity Services por meio da galeria
Antes de configurar o Microsoft Entra ID para ter o provisionamento automático de usuário no SAP Cloud Identity Services; você precisa adicionar o SAP Cloud Identity Services da galeria de aplicativos do Microsoft Entra à lista de aplicativos empresariais do locatário. Você pode fazer essa etapa no centro de administração do Microsoft Entra ou por meio da API do Graph.
Se o SAP Cloud Identity Services já estiver configurado para logon único do Microsoft Entra e um aplicativo já estiver presente na sua lista de aplicativos empresariais do Microsoft Entra, continue na próxima seção.
Para adicionar o SAP Cloud Identity Services da galeria de aplicativos do Microsoft Entra usando o centro de administração do Microsoft Entra, execute as seguintes etapas:
- Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
- Navegue até Entrar ID>Aplicativos empresariais>Novo aplicativo.
- Para adicionar o aplicativo por meio da galeria, digite SAP Cloud Identity Services na caixa de pesquisa.
- Selecione SAP Cloud Identity Services no painel de resultados e adicione o aplicativo. Aguarde alguns segundos enquanto o aplicativo é adicionado ao seu locatário.
Configurar o provisionamento automático de usuário para o SAP Cloud Identity Services
Esta seção orienta você pelas etapas para configurar o serviço de provisionamento do Microsoft Entra para criar, atualizar e desabilitar usuários e grupos no SAP Cloud Identity Services com base em atribuições de usuário e grupo para um aplicativo na ID do Microsoft Entra.
Para configurar o provisionamento automático de usuário para o SAP Cloud Identity Services no Microsoft Entra ID:
Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
Navegar para Entra ID>Aplicativos corporativos
Na lista de aplicativos, selecione o aplicativo, SAP Cloud Identity Services.
Clique na guia Propriedades.
Verifique se a opção Atribuição necessária? está definida como Sim. Se ela estiver definida como Não, todos os usuários no diretório, incluindo as identidades externas, poderão acessar o aplicativo e você não poderá revisar o acesso a ele.
Selecione a guia Provisionamento.
Defina o Modo de Provisionamento como Automático.
Na seção Credenciais de Administrador , selecione a Concessão de Credenciais do Cliente OAuth2. Entrada
https://<tenantID>.accounts.ondemand.com/scim, ouhttps://<tenantid>.trial-accounts.ondemand.com/scimcaso seja uma avaliação, com o ID do tenant dos SAP Cloud Identity Services na URL do tenant. Insira o ponto de extremidade de token, que pode ser semelhante a estehttps://<tenantID>.accounts.ondemand.com/oauth2/token. Insira os valores da ID do cliente e do Segredo do Cliente que você gerou anteriormente no console de administração do SAP Cloud Identity Services. Selecione Testar Conexão para garantir que a ID do Microsoft Entra possa se conectar ao SAP Cloud Identity Services. Se a conexão falhar, certifique-se de que a sua conta do sistema SAP Cloud Identity Services tem permissões de administrador e de que o segredo ainda seja válido e tente novamente.
No campo Notificação por Email, insira o endereço de email de uma pessoa ou grupo que deverá receber as notificações de erro de provisionamento e selecione a caixa de seleção - Enviar uma notificação por email quando ocorrer uma falha.
Clique em Salvar.
Na seção Mapeamentos , selecione Provisionar usuários da ID do Microsoft Entra ou Provisionar grupos de ID do Microsoft Entra , dependendo do seu cenário.
Examine os atributos de usuário e grupo sincronizados da ID do Microsoft Entra para o SAP Cloud Identity Services na seção Mapeamento de Atributos . Se você não vir os atributos em seus Serviços de Identidade de Nuvem do SAP disponíveis como um destino para mapeamento, selecione Mostrar opções avançadas e selecione Editar lista de atributos para o Serviço de Autenticação de Identidade da SAP Cloud Platform para editar a lista de atributos com suporte. Adicione os atributos do locatário do SAP Cloud Identity Services.
Examine e registre os atributos de origem e destino selecionados como propriedades correspondentes , mapeamentos que têm uma precedência correspondente, pois esses atributos são usados para corresponder aos usuários e grupos no SAP Cloud Identity Services para o serviço de provisionamento do Microsoft Entra para determinar se deseja criar um novo usuário/grupo ou atualizar um usuário/grupo existente. Para obter mais informações sobre correspondência, confira correspondência de usuários nos sistemas de origem e de destino. Em uma etapa subsequente, você garante que todos os usuários que já estão no SAP Cloud Identity Services tenham os atributos selecionados como propriedades correspondentes preenchidas, para impedir que usuários duplicados sejam criados.
Confirme se há um mapeamento de atributo para
IsSoftDeleted, ou uma função que contémIsSoftDeleted, mapeado para um atributo do aplicativo. Quando um usuário tiver a atribuição ao aplicativo removida ou for excluído de forma reversível no Microsoft Entra ID ou impedido de entrar, o serviço de provisionamento do Microsoft Entra atualizará o atributo mapeado paraisSoftDeleted. Se nenhum atributo for mapeado, os usuários que tiverem posteriormente a atribuição removida da função de aplicativo continuarão a existir no armazenamento de dados do aplicativo.Adicione todos os mapeamentos adicionais que os seus SAP Cloud Identity Services ou sistemas SAP de destino downstream exigem.
Selecione o botão Salvar para confirmar as alterações.
Atributo de Usuário Tipo Com suporte para filtragem Exigido pelo SAP Cloud Identity Services userNamefio ✓ ✓ emails[type eq "work"].valuefio ✓ activebooleano displayNamefio urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:managerReferência addresses[type eq "work"].countryfio addresses[type eq "work"].localityfio addresses[type eq "work"].postalCodefio addresses[type eq "work"].regionfio addresses[type eq "work"].streetAddressfio name.givenNamefio name.familyNamefio name.honorificPrefixfio phoneNumbers[type eq "fax"].valuefio phoneNumbers[type eq "mobile"].valuefio phoneNumbers[type eq "work"].valuefio urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenterfio urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:departmentfio urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:divisionfio urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumberfio urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organizationfio localefio timezonefio userTypefio companyfio urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute1fio urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute2fio urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute3fio urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute4fio urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute5fio urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute6fio urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute7fio urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute8fio urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute9fio urn:sap:cloud:scim:schemas:extension:custom:2.0:User:attributes:customAttribute10fio sendMailfio mailVerifiedfio Atributo de grupo Tipo Com suporte para filtragem Exigido pelo SAP Cloud Identity Services idfio ✓ ✓ externalIdfio displayNamefio ✓ urn:sap:cloud:scim:schemas:extension:custom:2.0:Group:namefio urn:sap:cloud:scim:schemas:extension:custom:2.0:Group:descriptionfio membersReferência ✓ Para configurar filtros de escopo, consulte as instruções a seguir fornecidas no artigo de filtro de escopo .
Para habilitar o serviço de provisionamento do Microsoft Entra ID para o SAP Cloud Identity Services, altere o Status de provisionamento para Ativado na seção Configurações.
Para o valor de Escopo na seção Configurações, selecione Sincronizar somente usuários e grupos atribuídos.
Quando estiver pronto para provisionar, selecione Salvar.
Essa operação inicia a sincronização inicial de todos os usuários definidos em Escopo, na seção Configurações. Se você tiver o escopo definido como Sincronizar somente usuários e grupos atribuídos e nenhum usuário ou grupo tiver sido atribuído ao aplicativo, nenhuma sincronização ocorrerá até que os usuários sejam atribuídos ao aplicativo.
Provisionar um novo usuário de teste do Microsoft Entra ID para o SAP Cloud Identity Services
É recomendável que um único novo usuário de teste do Microsoft Entra seja atribuído ao SAP Cloud Identity Services para testar a configuração de provisionamento automático de usuário.
- Entre no centro de administração do Microsoft Entra como pelo menos um Administrador de aplicativos de nuvem e um Administrador de usuários.
- Navegue até Entra ID>Usuários.
- Selecione Novo Usuário>Criar Novo Usuário.
- Digite o Nome da entidade de usuário e o Nome de exibição do novo usuário de teste. O nome da entidade de usuário deve ser exclusivo e não o mesmo de qualquer usuário atual ou anterior do Microsoft Entra ou usuário do SAP Cloud Identity Services. Selecione Examinar + criar e Criar.
- Depois que o usuário de teste for criado, navegue até Entra ID>Aplicativos empresariais.
- Selecione o aplicativo SAP Cloud Identity Services.
- Selecione Usuários e grupos e, em seguida, selecione Adicionar usuário/grupo.
- Nos Usuários e grupos, selecione Nenhum selecionado e, na caixa de texto, digite o nome da entidade de usuário do usuário de teste.
- Selecione Selecionar e, em seguida, Atribuir.
- Selecione Provisionamento e, em seguida, selecione Provisionar sob demanda.
- Na caixa de texto Selecionar um usuário ou grupo, digite o nome da entidade de usuário do usuário de teste.
- Selecione Provisionar.
- Aguarde a conclusão do provisionamento. Se tiver êxito, você verá a mensagem
Modified attributes (successful).
Opcionalmente, você também pode verificar o que o serviço de provisionamento do Microsoft Entra provisionará quando um usuário sair do escopo do aplicativo.
- Selecione Usuários e grupos.
- Selecione o usuário de teste e, em seguida, selecione Remover.
- Depois que o usuário de teste for removido, selecione Provisionamento e, em seguida, selecione Provisionar sob demanda.
- Na caixa de texto Selecionar um usuário ou grupo, digite o nome da entidade de usuário do usuário de teste cuja atribuição acabou de ser removida.
- Selecione Provisionar.
- Aguarde a conclusão do provisionamento.
Por fim, você pode remover o usuário de teste do Microsoft Entra ID.
- Navegue até Entra ID>Usuários.
- Selecione o usuário de teste, selecione Excluir e selecione OK. Esta ação exclui o usuário de teste do Microsoft Entra ID.
Você também pode remover o usuário de teste do SAP Cloud Identity Services.
Certifique-se de que os usuários existentes do SAP Cloud Identity Services tenham os atributos de correspondência necessários
Antes de atribuir usuários sem teste ao aplicativo SAP Cloud Identity Services no Microsoft Entra ID, você deve garantir que todos os usuários que já estejam no SAP Cloud Identity Services e que representem as mesmas pessoas que os usuários no Microsoft Entra ID tenham os atributos de mapeamento preenchidos no SAP Cloud Identity Services.
No mapeamento de provisionamento, os atributos selecionados como propriedades correspondentes são usados para corresponder as contas de usuário no Microsoft Entra ID com as contas de usuário no SAP Cloud Identity Services. Se houver um usuário no Microsoft Entra ID sem correspondência no SAP Cloud Identity Services, o serviço de provisionamento do Microsoft Entra tentará criar um novo usuário. Se houver um usuário no Microsoft Entra ID e uma correspondência no SAP Cloud Identity Services, o serviço de provisionamento do Microsoft Entra atualizará esse usuário do SAP Cloud Identity Services. Por esse motivo, você deve garantir que todos os usuários que já estão no SAP Cloud Identity Services tenham os atributos selecionados como propriedades correspondentes preenchidos, caso contrário, poderão ser criados usuários duplicados. Se você precisar alterar o atributo correspondente no mapeamento de atributo de aplicativo do Microsoft Entra, confira correspondência de usuários nos sistemas de origem e de destino.
Entre no console de administrador do SAP Cloud Identity Services,
https://<tenantID>.accounts.ondemand.com/adminouhttps://<tenantID>.trial-accounts.ondemand.com/adminse for uma avaliação.Navegue até Usuários e Autorizações > Exportar Usuários.
Selecione todos os atributos necessários para fazer a correspondência dos usuários do Microsoft Entra com os do SAP. Esses atributos incluem
SCIM ID,userName,emailse outros atributos que você pode estar usando em seus sistemas SAP como identificadores.Selecione Exportar e aguarde o navegador baixar o arquivo CSV.
Abra uma janela do PowerShell.
Digite o script a seguir em um editor. Na linha um, se você selecionou um atributo correspondente diferente de
userName, altere o valor da variávelsapScimUserNameFieldpara o nome do atributo SAP Cloud Identity Services. Na linha dois, altere o argumento para o nome do arquivo CSV exportado deUsers-exported-from-sap.csvpara o nome do arquivo baixado.$sapScimUserNameField = "userName" $existingSapUsers = import-csv -Path ".\Users-exported-from-sap.csv" -Encoding UTF8 $count = 0 $warn = 0 foreach ($u in $existingSapUsers) { $id = $u.id if (($null -eq $id) -or ($id.length -eq 0)) { write-error "Exported CSV file doesn't contain the ID attribute of SAP Cloud Identity Services users." throw "ID attribute not available, re-export" return } $count++ $userName = $u.$sapScimUserNameField if (($null -eq $userName) -or ($userName.length -eq 0)) { write-warning "SAP Cloud Identity Services user $id doesn't have a $sapScimUserNameField attribute populated" $warn++ } } write-output "$warn of $count users in SAP Cloud Identity Services did not have the $sapScimUserNameFIeld attribute populated."Execute o script. Quando o script for concluído, se houver um ou mais usuários sem o atributo correspondente necessário, procure esses usuários no arquivo CSV exportado ou no Console de Administração do SAP Cloud Identity Services. Se esses usuários também estiverem presentes no Microsoft Entra, primeiro você precisará atualizar a representação do SAP Cloud Identity Services desses usuários para que eles tenham o atributo correspondente preenchido.
Depois de atualizar os atributos desses usuários no SAP Cloud Identity Services, exporte novamente os usuários do SAP Cloud Identity Services, conforme descrito nas etapas 2 a 5 e etapas do PowerShell nesta seção, para confirmar que nenhum usuário no SAP Cloud Identity Services não possua os atributos correspondentes, o que impediria o provisionamento para esses usuários.
Agora que você tem uma lista de todos os usuários obtidos do SAP Cloud Identity Services, você compara esses usuários da base de dados do aplicativo com os usuários que já estão no Microsoft Entra ID, para determinar quais usuários devem estar no escopo do provisionamento.
Recuperar as IDs dos usuários no Microsoft Entra ID
Esta seção mostra como interagir com o Microsoft Entra ID usando cmdlets do PowerShell do Microsoft Graph.
Na primeira vez que sua organização usar esses cmdlets nesse cenário, você precisará ter a função de Administrador global para permitir que o PowerShell do Microsoft Graph seja usado no seu locatário. As interações subsequentes podem usar uma função com privilégios inferiores, como:
- Administrador de Usuário, caso preveja a criação de usuários.
- Administrador de aplicativos ou Administrador de governança de identidade, caso esteja apenas gerenciando atribuições de função de aplicativos.
Abra o PowerShell.
Se você ainda não tiver os módulos do PowerShell do Microsoft Graph instalados, instale o módulo
Microsoft.Graph.Userse os demais usando este comando:Install-Module Microsoft.GraphSe você já tiver os módulos instalados, verifique se está usando uma versão recente:
Update-Module microsoft.graph.users,microsoft.graph.identity.governance,microsoft.graph.applicationsConecte-se ao Microsoft Entra ID:
$msg = Connect-MgGraph -ContextScope Process -Scopes "User.ReadWrite.All,Application.ReadWrite.All,AppRoleAssignment.ReadWrite.All,EntitlementManagement.ReadWrite.All"Se esta for a primeira vez que você usa este comando, talvez seja necessário dar consentimento para que as ferramentas de linha de comando do Microsoft Graph acessem essas permissões.
Leia a lista de usuários obtida do armazenamento de dados do aplicativo na sessão do PowerShell. Se a lista de usuários estiver em um arquivo CSV, você poderá usar o cmdlet
Import-Csvdo PowerShell e fornecer o nome do arquivo da seção anterior como argumento.Por exemplo, se você tiver um arquivo chamado Users-exported-from-sap.csv que foi obtido do SAP Cloud Identity Services e ele estiver localizado no diretório atual, insira este comando.
$filename = ".\Users-exported-from-sap.csv" $dbusers = Import-Csv -Path $filename -Encoding UTF8Nesse outro exemplo: se você estiver usando um banco de dados ou diretório e o arquivo se chamar users.csv e também estiver localizado no diretório atual, insira este comando:
$filename = ".\users.csv" $dbusers = Import-Csv -Path $filename -Encoding UTF8Escolha a coluna do arquivo users.csv que corresponderá a um atributo de um usuário no Microsoft Entra ID.
E se você estiver usando o SAP Cloud Identity Services, o mapeamento padrão será o atributo
userNamedo SAP SCIM com o atributouserPrincipalNamedo Microsoft Entra ID:$db_match_column_name = "userName" $azuread_match_attr_name = "userPrincipalName"Outro exemplo seria se você estiver usando um banco de dados ou diretório, pode haver usuários em um banco de dados em que o valor na coluna denominada
EMailé o mesmo valor do atributouserPrincipalNamedo Microsoft Entra:$db_match_column_name = "EMail" $azuread_match_attr_name = "userPrincipalName"Recupere as IDs desses usuários no Microsoft Entra ID.
O script do PowerShell a seguir usa os valores
$dbusers,$db_match_column_namee$azuread_match_attr_nameespecificados anteriormente. Ele consultará o Microsoft Entra ID para localizar um usuário que tenha um atributo com um valor correspondente para cada registro no arquivo de origem. Se o arquivo obtido do SAP Cloud Identity Services, do banco de dados ou do diretório tiver muitos usuários, prepare-se para aguardar alguns minutos até que o script seja concluído. Se você não tiver um atributo no Microsoft Entra ID que tenha o valor e precisar usarcontainsou outra expressão de filtro, será necessário personalizar esse script e o da etapa 11 abaixo para usar uma expressão de filtro diferente.$dbu_not_queried_list = @() $dbu_not_matched_list = @() $dbu_match_ambiguous_list = @() $dbu_query_failed_list = @() $azuread_match_id_list = @() $azuread_not_enabled_list = @() $dbu_values = @() $dbu_duplicate_list = @() foreach ($dbu in $dbusers) { if ($null -ne $dbu.$db_match_column_name -and $dbu.$db_match_column_name.Length -gt 0) { $val = $dbu.$db_match_column_name $escval = $val -replace "'","''" if ($dbu_values -contains $escval) { $dbu_duplicate_list += $dbu; continue } else { $dbu_values += $escval } $filter = $azuread_match_attr_name + " eq '" + $escval + "'" try { $ul = @(Get-MgUser -Filter $filter -All -Property Id,accountEnabled -ErrorAction Stop) if ($ul.length -eq 0) { $dbu_not_matched_list += $dbu; } elseif ($ul.length -gt 1) {$dbu_match_ambiguous_list += $dbu } else { $id = $ul[0].id; $azuread_match_id_list += $id; if ($ul[0].accountEnabled -eq $false) {$azuread_not_enabled_list += $id } } } catch { $dbu_query_failed_list += $dbu } } else { $dbu_not_queried_list += $dbu } }Exiba os resultados das consultas anteriores. Veja se algum do usuário que está no SAP Cloud Identity Services, no banco de dados ou no diretório não pôde ser encontrado no Microsoft Entra ID, devido a erros ou correspondências faltando.
O seguinte script do PowerShell exibirá as contagens de registros que não foram localizados:
$dbu_not_queried_count = $dbu_not_queried_list.Count if ($dbu_not_queried_count -ne 0) { Write-Error "Unable to query for $dbu_not_queried_count records as rows lacked values for $db_match_column_name." } $dbu_duplicate_count = $dbu_duplicate_list.Count if ($dbu_duplicate_count -ne 0) { Write-Error "Unable to locate Microsoft Entra ID users for $dbu_duplicate_count rows as multiple rows have the same value" } $dbu_not_matched_count = $dbu_not_matched_list.Count if ($dbu_not_matched_count -ne 0) { Write-Error "Unable to locate $dbu_not_matched_count records in Microsoft Entra ID by querying for $db_match_column_name values in $azuread_match_attr_name." } $dbu_match_ambiguous_count = $dbu_match_ambiguous_list.Count if ($dbu_match_ambiguous_count -ne 0) { Write-Error "Unable to locate $dbu_match_ambiguous_count records in Microsoft Entra ID as attribute match ambiguous." } $dbu_query_failed_count = $dbu_query_failed_list.Count if ($dbu_query_failed_count -ne 0) { Write-Error "Unable to locate $dbu_query_failed_count records in Microsoft Entra ID as queries returned errors." } $azuread_not_enabled_count = $azuread_not_enabled_list.Count if ($azuread_not_enabled_count -ne 0) { Write-Error "$azuread_not_enabled_count users in Microsoft Entra ID are blocked from sign-in." } if ($dbu_not_queried_count -ne 0 -or $dbu_duplicate_count -ne 0 -or $dbu_not_matched_count -ne 0 -or $dbu_match_ambiguous_count -ne 0 -or $dbu_query_failed_count -ne 0 -or $azuread_not_enabled_count) { Write-Output "You will need to resolve those issues before access of all existing users can be reviewed." } $azuread_match_count = $azuread_match_id_list.Count Write-Output "Users corresponding to $azuread_match_count records were located in Microsoft Entra ID."Quando o script for concluído, ele indicará um erro se houver registros da fonte de dados não localizados no Microsoft Entra ID. Se nem todos os registros de usuários do armazenamento de dados do aplicativo puderem ser localizados no Microsoft Entra ID, será necessário investigar os registros que não corresponderam e por quê.
Por exemplo, o endereço de email e o userPrincipalName de alguém podem ter sido alterados no Microsoft Entra ID sem que a propriedade
mailcorrespondente tenha sido atualizada na fonte de dados do aplicativo. Ou talvez o usuário já tenha deixado a organização, mas ainda continue na fonte de dados do aplicativo. Ou pode haver uma conta de fornecedor ou de superadministrador na fonte de dados do aplicativo que não corresponda a nenhuma pessoa específica no Microsoft Entra ID.Se houver usuários que não foram localizados no Microsoft Entra ID ou que não estavam ativos e prontos para entrar, mas você quer que eles tenham o acesso revisado ou seus atributos atualizados no SAP Cloud Identity Services, no banco de dados ou no diretório, você precisará atualizar o aplicativo ou a regra de correspondência, ou então atualizar ou criar usuários do Microsoft Entra para eles. Para mais informações sobre quais alterações fazer, confira gerenciar mapeamentos e contas de usuário em aplicativos que encontraram correspondência com os usuários no Microsoft Entra ID.
Se você optar por criar usuários no Microsoft Entra ID, poderá criar usuários em massa usando:
- Um arquivo CSV, conforme descrito em Criar usuários em massa no centro de administração do Microsoft Entra
- O cmdlet New-MgUser
Verifique se os novos usuários foram preenchidos com os atributos necessários para que o Microsoft Entra ID combine-os posteriormente com os usuários existentes no aplicativo e com os atributos exigidos pelo Microsoft Entra ID, incluindo
userPrincipalName,mailNicknameedisplayName. OuserPrincipalNamedeve ser único entre todos os usuários no diretório.Por exemplo, é possível ter usuários em um banco de dados em que o valor na coluna
EMailé o valor que você quer usar como o nome UPN do Microsoft Entra, o valor na colunaAliascontém o apelido de email do Microsoft Entra ID e o valor na colunaFull namecontém o nome de exibição do usuário:$db_display_name_column_name = "Full name" $db_user_principal_name_column_name = "Email" $db_mail_nickname_column_name = "Alias"Depois, você pode usar este script para criar usuários do Microsoft Entra para aqueles que estão no SAP Cloud Identity Services, no banco de dados ou no diretório que não correspondem aos usuários no Microsoft Entra ID. Observe que talvez seja necessário modificar esse script para adicionar outros atributos do Microsoft Entra necessários em sua organização ou, se
$azuread_match_attr_namenão formailNicknamenemuserPrincipalName, para fornecer esse atributo do Microsoft Entra.$dbu_missing_columns_list = @() $dbu_creation_failed_list = @() foreach ($dbu in $dbu_not_matched_list) { if (($null -ne $dbu.$db_display_name_column_name -and $dbu.$db_display_name_column_name.Length -gt 0) -and ($null -ne $dbu.$db_user_principal_name_column_name -and $dbu.$db_user_principal_name_column_name.Length -gt 0) -and ($null -ne $dbu.$db_mail_nickname_column_name -and $dbu.$db_mail_nickname_column_name.Length -gt 0)) { $params = @{ accountEnabled = $false displayName = $dbu.$db_display_name_column_name mailNickname = $dbu.$db_mail_nickname_column_name userPrincipalName = $dbu.$db_user_principal_name_column_name passwordProfile = @{ Password = -join (((48..90) + (96..122)) * 16 | Get-Random -Count 16 | % {[char]$_}) } } try { New-MgUser -BodyParameter $params } catch { $dbu_creation_failed_list += $dbu; throw } } else { $dbu_missing_columns_list += $dbu } }Quando adicionar os usuários ausentes ao Microsoft Entra ID, execute o script da etapa 7 novamente. Em seguida, execute o script da etapa 8. Verifique se não há nenhum erro relatado.
$dbu_not_queried_list = @() $dbu_not_matched_list = @() $dbu_match_ambiguous_list = @() $dbu_query_failed_list = @() $azuread_match_id_list = @() $azuread_not_enabled_list = @() $dbu_values = @() $dbu_duplicate_list = @() foreach ($dbu in $dbusers) { if ($null -ne $dbu.$db_match_column_name -and $dbu.$db_match_column_name.Length -gt 0) { $val = $dbu.$db_match_column_name $escval = $val -replace "'","''" if ($dbu_values -contains $escval) { $dbu_duplicate_list += $dbu; continue } else { $dbu_values += $escval } $filter = $azuread_match_attr_name + " eq '" + $escval + "'" try { $ul = @(Get-MgUser -Filter $filter -All -Property Id,accountEnabled -ErrorAction Stop) if ($ul.length -eq 0) { $dbu_not_matched_list += $dbu; } elseif ($ul.length -gt 1) {$dbu_match_ambiguous_list += $dbu } else { $id = $ul[0].id; $azuread_match_id_list += $id; if ($ul[0].accountEnabled -eq $false) {$azuread_not_enabled_list += $id } } } catch { $dbu_query_failed_list += $dbu } } else { $dbu_not_queried_list += $dbu } } $dbu_not_queried_count = $dbu_not_queried_list.Count if ($dbu_not_queried_count -ne 0) { Write-Error "Unable to query for $dbu_not_queried_count records as rows lacked values for $db_match_column_name." } $dbu_duplicate_count = $dbu_duplicate_list.Count if ($dbu_duplicate_count -ne 0) { Write-Error "Unable to locate Microsoft Entra ID users for $dbu_duplicate_count rows as multiple rows have the same value" } $dbu_not_matched_count = $dbu_not_matched_list.Count if ($dbu_not_matched_count -ne 0) { Write-Error "Unable to locate $dbu_not_matched_count records in Microsoft Entra ID by querying for $db_match_column_name values in $azuread_match_attr_name." } $dbu_match_ambiguous_count = $dbu_match_ambiguous_list.Count if ($dbu_match_ambiguous_count -ne 0) { Write-Error "Unable to locate $dbu_match_ambiguous_count records in Microsoft Entra ID as attribute match ambiguous." } $dbu_query_failed_count = $dbu_query_failed_list.Count if ($dbu_query_failed_count -ne 0) { Write-Error "Unable to locate $dbu_query_failed_count records in Microsoft Entra ID as queries returned errors." } $azuread_not_enabled_count = $azuread_not_enabled_list.Count if ($azuread_not_enabled_count -ne 0) { Write-Warning "$azuread_not_enabled_count users in Microsoft Entra ID are blocked from sign-in." } if ($dbu_not_queried_count -ne 0 -or $dbu_duplicate_count -ne 0 -or $dbu_not_matched_count -ne 0 -or $dbu_match_ambiguous_count -ne 0 -or $dbu_query_failed_count -ne 0 -or $azuread_not_enabled_count -ne 0) { Write-Output "You will need to resolve those issues before access of all existing users can be reviewed." } $azuread_match_count = $azuread_match_id_list.Count Write-Output "Users corresponding to $azuread_match_count records were located in Microsoft Entra ID."
Certifique-se de que os usuários existentes do Microsoft Entra tenham os atributos necessários
Antes de habilitar o provisionamento automático de usuário, você deve decidir quais usuários no Microsoft Entra ID precisam de acesso ao SAP Cloud Identity Services e, em seguida, você precisa certificar-se de que esses usuários tenham os atributos necessários no Microsoft Entra ID e esses atributos sejam mapeados para o esquema esperado do SAP Cloud Identity Services.
- Por padrão, o valor do atributo de usuário do Microsoft Entra
userPrincipalNameé mapeado para o e os atributosuserNameeemails[type eq "work"].valuedo SAP Cloud Identity Services. Se os endereços de email do usuário forem diferentes de seus nomes de entidade de usuário, talvez seja necessário alterar esse mapeamento. - O SAP Cloud Identity Services poderá ignorar os valores do atributo
postalCodese o formato do CEP da empresa não corresponder ao país ou região dela. - Por padrão, o atributo
countryMicrosoft Entra é mapeado para o campoaddresses[type eq "work"].countrySAP Cloud Identity Services. Se os valores docountryatributo não forem códigos de país ISO 3166 de dois caracteres, a criação desses usuários no SAP Cloud Identity Services poderá falhar. Para obter mais informações, consulte countries.properties. - Por padrão, o atributo
departmentdo Microsoft Entra é mapeado para o atributourn:ietf:params:scim:schemas:extension:enterprise:2.0:User:departmentdo SAP Cloud Identity Services. Se os usuários do Microsoft Entra tiverem valores do atributodepartment, esses valores deverão corresponder aos departamentos já configurados no SAP Cloud Identity Services; caso contrário, a criação ou atualização do usuário falhará. Para obter mais informações, consulte departments.properties. Se osdepartmentvalores em seus usuários do Microsoft Entra não forem consistentes com aqueles em seu ambiente SAP, atualize os valores de departamento no Microsoft Entra, atualize os valores de departamento permitidos no SAP Cloud Identity Services ou remova o mapeamento antes de atribuir usuários. - O ponto de extremidade SCIM do SAP Cloud Identity Services exige que determinados atributos sejam de um formato específico. Você pode saber mais sobre esses atributos e o formato específico deles aqui.
Atribuir usuários ao aplicativo do SAP Cloud Identity Services no Microsoft Entra ID
O Microsoft Entra ID usa um conceito chamado atribuições para determinar quais usuários devem receber acesso aos aplicativos selecionados. No contexto do provisionamento automático de usuário, se o valor de configurações do Escopo for Sincronizar somente usuários e grupos atribuídos, somente os usuários e grupos atribuídos a uma função de aplicativo desse aplicativo no Microsoft Entra ID serão sincronizados com o SAP Cloud Identity Services. Ao atribuir um usuário ao SAP Cloud Identity Services, é necessário selecionar qualquer função específica ao aplicativo válida (se disponível) na caixa de diálogo de atribuição. Usuários com a função Acesso padrão são excluídos do provisionamento. Atualmente, a única função disponível para o SAP Cloud Identity Services é Usuário.
Se o provisionamento já tiver sido habilitado para o aplicativo, verifique se o provisionamento de aplicativos não está em quarentena antes de atribuir mais usuários ao aplicativo. Resolva os problemas que estão causando a quarentena antes de prosseguir.
Verifique os usuários que estão presentes no SAP Cloud Identity Services e que ainda não estão atribuídos ao aplicativo no Microsoft Entra ID
As etapas anteriores avaliaram se os usuários no SAP Cloud Identity Services também existem como usuários no Microsoft Entra ID. No entanto, pode ser que nem todos tenham as funções do aplicativo atribuídas no Microsoft Entra ID. Portanto, as próximas etapas se destinam a ver os usuários que não têm atribuições de funções de aplicativo.
Usando o PowerShell, procure a ID da entidade de serviço para a entidade de serviço do aplicativo.
Por exemplo, se o nome do aplicativo empresarial for
SAP Cloud Identity Services, digite os seguintes comandos:$azuread_app_name = "SAP Cloud Identity Services" $azuread_sp_filter = "displayName eq '" + ($azuread_app_name -replace "'","''") + "'" $azuread_sp = Get-MgServicePrincipal -Filter $azuread_sp_filter -AllRecupere os usuários que atualmente têm atribuições para o aplicativo no Microsoft Entra ID.
Isso se baseia na variável
$azuread_spdefinida no comando anterior.$azuread_existing_assignments = @(Get-MgServicePrincipalAppRoleAssignedTo -ServicePrincipalId $azuread_sp.Id -All)Compare a lista de IDs de usuário dos usuários que já estão no SAP Cloud Identity Services e no Microsoft Entra ID aos usuários atualmente atribuídos ao aplicativo no Microsoft Entra ID. Este script se baseia na variável
$azuread_match_id_listdefinida nas seções anteriores:$azuread_not_in_role_list = @() foreach ($id in $azuread_match_id_list) { $found = $false foreach ($existing in $azuread_existing_assignments) { if ($existing.principalId -eq $id) { $found = $true; break; } } if ($found -eq $false) { $azuread_not_in_role_list += $id } } $azuread_not_in_role_count = $azuread_not_in_role_list.Count Write-Output "$azuread_not_in_role_count users in the application's data store aren't assigned to the application roles."Se zero usuários não forem atribuídos a funções de aplicativo, indicando que todos os usuários são atribuídos a funções de aplicativo, isso indica que não havia usuários em comum entre o Microsoft Entra ID e o SAP Cloud Identity Services, portanto, nenhuma alteração é necessária. No entanto, se um ou mais usuários que já estão no SAP Cloud Identity Services não estiverem atribuídos atualmente às funções de aplicativo, você precisará continuar o procedimento e adicioná-los a uma das funções do aplicativo.
Selecione a função
Userda entidade de serviço de aplicativo.$azuread_app_role_name = "User" $azuread_app_role_id = ($azuread_sp.AppRoles | where-object {$_.AllowedMemberTypes -contains "User" -and $_.DisplayName -eq "User"}).Id if ($null -eq $azuread_app_role_id) { write-error "role $azuread_app_role_name not located in application manifest"}Crie atribuições de função de aplicativo para usuários que já estão presentes no SAP Cloud Identity Services e no Microsoft Entra e atualmente não têm atribuições de função para o aplicativo:
foreach ($u in $azuread_not_in_role_list) { $res = New-MgServicePrincipalAppRoleAssignedTo -ServicePrincipalId $azuread_sp.Id -AppRoleId $azuread_app_role_id -PrincipalId $u -ResourceId $azuread_sp.Id }Aguarde um minuto para que as alterações sejam propagadas no Microsoft Entra ID.
No próximo ciclo de provisionamento do Microsoft Entra, o serviço de provisionamento do Microsoft Entra comparará a representação desses usuários atribuídos ao aplicativo à representação no SAP Cloud Identity Services e atualizará os usuários do SAP Cloud Identity Services para ter os atributos do Microsoft Entra ID.
Atribuir usuários restantes e monitorar a sincronização inicial
Depois que o teste tiver sido concluído, um usuário tiver sido provisionado com êxito no SAP Cloud Identity Services, e todos os usuários existentes do SAP Cloud Identity Services tenham sido atribuídos à função de aplicativo, você poderá atribuir quaisquer usuários autorizados adicionais ao aplicativo SAP Cloud Identity Services seguindo uma das instruções aqui:
- Você pode atribuir cada usuário individual ao aplicativo no centro de administração do Microsoft Entra,
- Você pode atribuir usuários individuais ao aplicativo por meio do cmdlet
New-MgServicePrincipalAppRoleAssignedTodo PowerShell, conforme mostrado na seção anterior, ou - se sua organização tiver uma licença para o Microsoft Entra ID Governance, você também poderá implantar políticas de gerenciamento de direitos para automatizar a atribuição de acesso.
Depois que os usuários forem atribuídos à função de aplicativo e estiverem no escopo do provisionamento, o serviço de provisionamento do Microsoft Entra os provisionará para o SAP Cloud Identity Services. Observe que a sincronização inicial leva mais tempo para ser executada do que as sincronizações subsequentes, que ocorrem aproximadamente a cada 40 minutos, desde que o serviço de provisionamento do Microsoft Entra esteja em execução.
Se você não vir usuários sendo provisionados, examine as etapas no guia de solução de problemas relacionados ao não provisionamento de usuários. Em seguida, verifique o log de provisionamento por meio do centro de administração do Microsoft Entra ou das APIs do Graph. Filtre o log para o status Falha. Se houver erros com o código de erro DuplicateTargetEntries, isso indicará uma ambiguidade em suas regras de associação de provisionamento e você precisará atualizar os usuários do Microsoft Entra ou os mapeamentos usados para garantir que cada usuário do Microsoft Entra seja associado a um único usuário do aplicativo. Depois, filtre o log para a ação Criar e o status Ignorado. Se os usuários foram ignorados com o código SkipReason de NotEffectivelyEntitled, isso pode indicar que as contas de usuário no Microsoft Entra ID não foram correspondidas porque o status da conta de usuário estava desabilitado.
Configurar logon único
Você também pode optar por habilitar o logon único baseado em SAML para o SAP Cloud Identity Services, seguindo as instruções fornecidas no artigo de logon único do SAP Cloud Identity Services. O logon único pode ser configurado independentemente do provisionamento automático de usuário, embora esses dois recursos sejam complementares.
Monitorar o provisionamento
Use a seção Detalhes de Sincronização para monitorar o progresso e siga os links para o relatório de atividades de provisionamento, que descreve todas as ações executadas pelo serviço de provisionamento do Microsoft Entra ID no SAP Cloud Identity Services. Você também pode monitorar o projeto de provisionamento por meio das APIs do Microsoft Graph.
Para obter mais informações sobre como ler os logs de provisionamento do Microsoft Entra, confira Relatórios sobre o provisionamento automático de contas de usuário.
Manter atribuições de função de aplicativo
À medida que os usuários atribuídos ao aplicativo são atualizados na ID do Microsoft Entra, essas alterações são provisionadas automaticamente para o SAP Cloud Identity Services.
Se você tiver o Microsoft Entra ID Governance, poderá automatizar as alterações nas atribuições de função de aplicativo para o SAP Cloud Identity Services no Microsoft Entra ID, adicionar ou remover atribuições à medida que as pessoas ingressarem na organização ou sair ou alterar funções.
- Você pode executar uma revisão de acesso única ou recorrente das atribuições de função de aplicativo.
- Você pode criar um pacote de acesso de gerenciamento de direitos para este aplicativo. Você pode ter políticas para que os usuários tenham acesso atribuído, quando solicitado por eles, por um administrador, automaticamente com base em regras ou por meio de fluxos de trabalho do ciclo de vida.
Atualizar um aplicativo do SAP Cloud Identity Services para usar o ponto de extremidade do SAP Cloud Identity Services SCIM 2.0
Em setembro de 2025, a Microsoft lançou um conector SCIM 2.0 para o SAP Cloud Identity Services que adicionou suporte para provisionamento e desprovisionamento de grupo ao SAP Cloud Identity Services, atributos de extensão personalizados e a concessão de Credenciais de Cliente do OAuth 2.0.
Concluir as etapas abaixo permitirá que os clientes que já estavam usando o conector do SAP Cloud Identity Services mudem do ponto de extremidade SCIM 1.0 para o ponto de extremidade SCIM 2.0.
Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
Navegue até Entra ID > Enterprise Apps > SAP Cloud Identity Services.
Na seção Propriedades , copie a ID do Objeto.
Em uma nova janela do navegador da Web, acesse https://developer.microsoft.com/graph/graph-explorer e entre como administrador do locatário do Microsoft Entra no qual seu aplicativo é adicionado.
Verifique se a conta que está sendo usada tem as permissões corretas. A permissão "Directory.ReadWrite.All" é necessária para fazer essa alteração.
Usando a ID de Objeto selecionada no aplicativo anteriormente, execute o comando a seguir.
GET https://graph.microsoft.com/beta/servicePrincipals/[object-id]/synchronization/jobs/
- Usando o valor "ID" do corpo da resposta da
GETsolicitação do exemplo anterior, execute o comando a seguir, substituindo "[job ID]" pelo valor de ID da solicitaçãoGET. O valor deve ter o formato de "sapcloudidentityservices.xxxxxxxxxxxxxxx.xxxxxxxxxxxxxxx".
DELETE https://graph.microsoft.com/beta/servicePrincipals/[object-id]/synchronization/jobs/[job-id]
- No Microsoft Graph Explorer, execute o comando a seguir. Substitua "[object-id]" pela ID da entidade de serviço (ID do objeto) copiada da terceira etapa.
POST https://graph.microsoft.com/beta/servicePrincipals/[object-id]/synchronization/jobs { "templateId": "sapcloudidentityservices" }
Retorne à primeira janela do navegador da Web e selecione a guia Provisionamento para seu aplicativo. Sua configuração é redefinida. Você pode confirmar se a atualização foi bem-sucedida confirmando que a ID do trabalho começa com "sapcloudidentityservices".
Atualize a URL do locatário na seção credenciais de administrador para o seguinte:
https://<tenantID>.accounts.ondemand.com/scimouhttps://<tenantid>.trial-accounts.ondemand.com/service/scimse uma avaliação.Restaure as alterações anteriores feitas no aplicativo (detalhes de autenticação, filtros de escopo, mapeamentos de atributo personalizados) e habilite novamente o provisionamento.
Observação
A falha ao restaurar as configurações anteriores pode resultar na atualização inesperada de atributos (name.formatted, por exemplo) no SAP Cloud Identity Services. Verifique a configuração antes de habilitar o provisionamento.
Changelog
- 30/09/2025 – Lançada para Disponibilidade Geral uma nova versão do conector do SAP Cloud Identity Services que usa um ponto de extremidade SCIM 2.0. A nova versão dá suporte ao provisionamento de grupo e ao desprovisionamento para o SAP Cloud Identity Services, atributos de extensão personalizados e a concessão de Credenciais de Cliente do OAuth 2.0.
Mais recursos
- Gerenciamento do provisionamento de conta de usuário para Aplicativos Empresariais
- O que é o acesso a aplicativos e logon único com o Microsoft Entra ID?
- Gerenciar o acesso aos aplicativos SAP
- Controlar o acesso a aplicativos em seu ambiente