Sincronize contas de usuário do Microsoft Entra ID para o Apple School Manager
Você pode usar o OpenID Connect (OIDC) para sincronizar as contas de usuário para o Apple School Manager. Usando esse sistema, você pode adicionar as propriedades do Apple School Manager (como nível de escolaridade e funções) com dados de conta de usuário importados do Microsoft Entra ID. Ao usar OIDC para sincronizar contas de usuário, as informações de conta são adicionadas como somente leitura até você se desconectar do Microsoft Entra ID. Nesse momento, as contas de usuário se tornam contas manuais e os atributos nessas contas podem então ser editados.
Antes de começar
Antes de sincronizar para o Microsoft Entra ID por meio de uma conexão OIDC, faça o seguinte:
Se necessário, configure e verifique o domínio que você deseja usar. Confira Vincule a novos domínios. Se você já verificou o domínio que deseja federar com o Google Workspace, ignore este processo.
Desconecte-se do Sistema de informações do aluno (SIS) ou pare de fazer upload usando SFTP.
Configure, faça a federação e ative um domínio. Consulte Use a autenticação federada com o Microsoft Federated ID.
Ao configurar a conexão, você deve usar o endereço de e-mail de um usuário que tenha a função de Administrador, Gerente de site ou Gerente de pessoas para que ele possa receber notificações do Microsoft Entra ID.
Tenha um administrador global disponível do Microsoft Entra ID com permissões para editar configurações do Microsoft Entra ID.
Contas de usuário do Microsoft Entra ID e funções do Apple School Manager
Quando uma conta de usuário for copiada do Microsoft Entra ID usando OIDC para o Apple School Manager, a função predefinida é Aluno. Depois que a sincronização for concluída, os seguintes atributos de conta de usuário podem ser editados:
Funções
Nível de ensino
Nome de usuário do Sistema de informações do aluno (SIS)
Esses atributos são armazenados com a conta de usuário no Apple School Manager e não são gravados no Microsoft Entra ID.
Importante: Não reutilize um nome de usuário por 120 dias no app Apple School Manager Entra ID.
Atributo de início de sessão
O Apple School Manager exige que o atributo usado para o ID Apple gerenciado seja exclusivo. Esse dado costuma ser o endereço de e-mail. Se um usuário tiver um atributo idêntico ao de um usuário existente do Apple School Manager com a função de Administrador, a sincronização não ocorrerá e o campo fonte permanecerá inalterado.
Nome principal do usuário
Se uma conta de usuário tiver um Nome principal do usuário (UPN) idêntico ao de uma conta de usuário existente que tenha a função de Administrador ou Gerenciador de sites ou Gerente de pessoas, nenhuma sincronização ocorrerá e o campo fonte permanecerá inalterado. Esta ação ocorre independentemente do método de sincronização usado originalmente (SIS ou SFTP).
ID de pessoa
Quando uma conta de usuário do Microsoft Entra ID for sincronizada com o Apple School Manager, será criado um ID de pessoa para a conta de usuário do Apple School Manager. O ID de pessoa é usado para identificar contas de usuário com conflito. Além disso, o ID da pessoa é gerado automaticamente para usuários importados usando o OIDC ou a integração com SIS, mas não é gerado automaticamente de usuários importados usando o SFTP.
Se o Microsoft Entra for desconectado e o SFTP for usado para fazer upload de usuários novamente, novos usuários serão criados, a menos que o ID de pessoa no arquivo de upload do SFTP corresponda ao ID de pessoa que foi atribuído pelo OIDC. Confira Importar contas usando SFTP.
Considerações importantes no caso de modificação do ID da pessoa:
Se você modificar o ID da pessoa para uma conta de usuário importada anteriormente do Microsoft Entra ID, essa conta não será mais emparelhada com o Microsoft Entra ID.
Se você modificar o ID de pessoa para uma conta de usuário importada do Microsoft Entra ID anteriormente e quiser reconectar a conta de usuário, consulte Resolver conflitos de conta de usuário do Microsoft Entra ID OIDC.
Locatários do Microsoft Entra ID
Para usar OIDC com Apple School Manager, a organização não deve ter o mesmo locatário do Microsoft Entra ID como qualquer outra organização do Apple School Manager. Se você quiser usar o OIDC para sua empresa, entre em contato com o administrador do Microsoft Entra ID para garantir que nenhuma outra empresa do esteja usando seu locatário do Entra ID para OIDC.
Grupos do Microsoft Entra ID
No Microsoft Entra ID, a interface de usuário permite que você sincronize contas de grupos, mas somente as contas de usuário que fazem parte destes grupos são compatíveis para a sincronização.
Se você tiver uma conta de grupo configurada no Microsoft Entra ID, você poderá adicionar esse grupo ao app Apple School Manager Entra ID em vez de adicionar cada usuário.
Nota: Subgrupos não são aceitos no app Apple School Manager Entra ID.
Mapeamento de atributo de usuário OIDC
Quando uma conta de usuário for copiada do Microsoft Entra ID usando OIDC para o Apple School Manager, os seguintes atributos de usuário são armazenados como somente leitura. A tabela também denota se o atributo de usuário é exigido.
Importante: Adicionar atributos não relacionados na tabela pode romper a conexão OIDC.
Atributo de usuário do Microsoft Entra ID | Atributo de usuário do Apple Business Essentials | Solicitado |
---|---|---|
Nome | Nome | |
sobrenome | Sobrenome | |
nomePrincipaldoUsuário | ID Apple gerenciado e endereço de e-mail | |
objectId | (Não mostrado no Apple School Manager. Esse atributo é usado para identificar contas com conflito.) | |
Departamento | Departamento | |
ID de funcionário | Número da pessoa | |
employeeOrgData.costCenter | Central de custos | |
employeeOrgData.division | Divisão |
Ativar o Microsoft Entra Connect Sync
No Apple School Manager , inicie sessão com uma conta que tenha a função de Administrador, Gerente de site ou Gerente de pessoas.
Selecione seu nome na parte inferior da barra lateral, selecione Preferências e depois Directory Sync .
Ative Microsoft Entra Connect Sync e depois selecione Sincronizar agora.
Sincronize manualmente
É possível sincronizar manualmente o Apple School Manager para o Microsoft Entra ID e importar as alterações feitas no Microsoft Entra ID.
No Apple School Manager , inicie sessão com uma conta que tenha a função de Administrador, Gerente de site ou Gerente de pessoas.
Selecione seu nome na parte inferior da barra lateral, selecione Preferências e depois Directory Sync .
Selecione Sincronizar agora em Microsoft Entra ID.