Guia de Campo SCIM para Entra ID e Okta
Um guia para criar mapeamentos SCIM personalizados entre Entra ID ou Okta e Zoom
Visão geral
A API SCIM2 do Zoom expõe um grande catálogo de atributos de usuário que controlam licenciamento, direitos de produto, funções, regiões e configuração por serviço. As integrações de provisionamento prontas para uso para Microsoft Entra ID e Okta mapeiam apenas um pequeno subconjunto disso — o suficiente para criar, atualizar e desativar usuários, mas não o suficiente para provisionar sites do Zoom Phone, pacotes de central de contato, funções do Revenue Accelerator ou qualquer um dos dezenas de outros atributos que o Zoom suporta.
Este guia ensina o método repetível para adicionar qualquer atributo SCIM do Zoom à sua configuração de provisionamento. Em vez de documentar um atributo isoladamente, ele explica o modelo subjacente para que os administradores possam consultar um atributo na referência da API SCIM2 do Zoom e Configurar isso de forma independente, sem esperar que um artigo específico do produto seja publicado.
Como usar este guia
Leia a Introdução começando com Entendendo os atributos SCIM primeiro, juntamente com as seções que seguem — pré-requisitos, dados do diretório, cenários de referência e Verificação do lado do Zoom. Eles se aplicam independentemente do provedor de identidade (IdP) que você usa. Em seguida, trabalhe na seção Microsoft Entra ID ou Okta, dependendo de qual você usa. Cada uma dessas partes é completa desde a primeira etapa de configuração até a Verificação e os exemplos práticos; você não precisará alternar entre elas.
Para os conceitos fundamentais de SSO e SCIM que sustentam este guia, consulte o Guia de Campo SSO, o artigo de SSO e provisionamento do Zoom para o Entra ID, e o Artigo de SSO da Zoom para Okta.
Pré-requisitos para usar SCIM
Tudo nesta parte se aplica independentemente do provedor de identidade. Leia isto antes de avançar para as instruções específicas do seu provedor de identidade.
Requisitos comuns a ambos os provedores de identidade
conta Zoom Corporativo (for plan)/Corporativa (for licence), Educação ou empresarial com um aprovado URL intuitivo
privilégios de proprietário da conta Zoom ou de administrador
logon único ativado na conta Zoom
Uma domínio associado verificado na conta Zoom, correspondendo ao domínio de e-mail dos usuários que estão sendo provisionados
O provisionamento SCIM já foi estabelecido entre o provedor de identidade e Zoom
A licença Zoom, plano, add-on ou objeto de configuração que está sendo atribuído já deve existir e estar Disponível na conta Zoom
Os requisitos específicos do fornecedor de identidade estão listados no início de cada secção respetiva.
Limitações comuns a ambos os provedores de identidade
O SCIM atribui apenas permissões existentes; não pode criar os objetos que referencia. Consulte a seção Antes de tentar o mapeamento avançado, os objetos do lado do Zoom devem existir antes que o SCIM possa referenciá-los abaixo.
Alguns atributos aceitam apenas um valor por usuário. Um Plano de tarifação de chamadas do Zoom Phone é um exemplo — pacotes add-on, como o Customer Engagement Pack, não podem ser provisionados por meio do SCIM.
O
tipo de utilizadoro atributo é documentado pelo Zoom como planejado para descontinuação.
Introdução
Entendendo os atributos SCIM
Os administradores que entendem como um atributo SCIM do Zoom é construído podem Configurar qualquer atributo que o Zoom suporte. Os administradores que seguem uma receita podem Configurar apenas o atributo que essa receita descreve. Esta seção aborda a construção. O mapeamento de um atributo para uma fonte de dados vem mais tarde, nas seções do provedor de identidade.
Todo atributo tem um espaço de nomes, um nome, um tipo de dados e um valor permitido
Vamos começar com um exemplo completo e funcional. Aqui está o identificador para atribuir um usuário a uma unidade do Zoom Phone:
Quatro propriedades deste atributo estão em jogo. Duas delas são visíveis na linha acima. As outras duas vêm da referência da API e são inseridas em outro lugar no seu provedor de identidade mais adiante. Para os nossos propósitos imediatos, estamos focados em duas: a Espaço de nomes e a Nome.
Espaço de nomes
urn:ietf:params:scim:schemas:extension:zoom:1.0:Usuário
Informa ao Zoom a que esquema a configuração pertence e atua como base compartilhada para quase todos os atributos de produto e licenciamento do Zoom. Transmitido ao Zoom como a primeira metade do identificador.
Nome
zoomPhoneSite
Identifica a configuração específica do Zoom que está sendo gravada — aqui, a unidade do Zoom Phone do usuário. Transmitido ao Zoom como a segunda metade do identificador. Sensível a maiúsculas e minúsculas.
Tipo de dados
string
Informa ao seu provedor de identidade que tipo de valor o atributo contém para que seja armazenado e formatado corretamente. Não é passado como parte do identificador; é declarado separadamente como Tipo no Entra ID, ou Tipo de dados no Okta.
Valor permitido
LON-01, um nome de unidade do Zoom Phone
A configuração realmente aplicada ao usuário. Texto livre para alguns atributos, um conjunto fixo para outros — Essentials, Premium, ou Elite para o Zoom central de contato, por exemplo. Passado para o Zoom no momento do provisionamento, fornecido pelo mapeamento em vez do identificador.
Localize o atributo de que você precisa na referência da API SCIM2
O Referência da API SCIM2 é a lista definitiva de tudo o que o Zoom aceita durante o provisionamento. Duas operações são importantes: Criar um usuário e Atualizar um usuário.
Trabalhe principalmente a partir de Atualizar um usuárioA criação acontece uma vez por pessoa, mas as Alterar de atributos acontecem continuamente — uma mudança de escritório, uma Alterar de plano, uma Alterar de Função, uma saída — portanto, a maior parte do que o provisionamento realmente faz ao longo do tempo são atualizações. Atualizar um usuário também documenta os valores de remoção que Criar um usuário não tem razão para incluir, como definir zoomPhoneCallingPlan para -1 para remover todos os planos de chamada de um usuário.
Para encontrar um atributo:
Abra a referência da API SCIM2 e vá para Atualizar um usuário.
No corpo da solicitação, localize o
urn:ietf:params:scim:schemas:extension:zoom:1.0:Usuárioobjeto. Todos os atributos abordados neste guia estão listados nele.Encontre seu atributo pelo nome e grave o seu tipo de dados e os seus valores permitidos.
Leia a descrição ao lado dele. As descrições trazem comportamentos que você não pode inferir pelo nome do atributo —
zoomPhoneExtNumberdefinido como0dispara a atribuição automática de ramal,zoomPhoneCallingPlandefinido como-1remove todos os planos de chamadas ezoomPhoneNumberdeve referenciar um número que já não está atribuído na conta Zoom.
Montando o identificador: pai, dois-pontos, filho
Tudo listado dentro desse urn:ietf:params:scim:schemas:extension:zoom:1.0:Usuário objeto é um filho dele. O próprio objeto é o pai. Construir um identificador significa nomear o pai, adicionar dois-pontos e depois adicionar o filho:
Essa é toda a construção. Não há nenhuma tabela de pesquisa para solicitar ao Zoom e nada a gerar — o identificador é duas coisas que você já tem, unidas por dois pontos.
O pai mantém-se o mesmo; apenas o filho muda
Como o pai está fixo, configurar um segundo, quinto ou décimo quinto atributo é a mesma ação com um filho diferente acrescentado:
O mesmo pai carrega todos os outros produtos Zoom. Nada sobre a construção muda quando o produto muda:
Você, portanto, aprende o elemento pai uma vez. A partir daí, configurar um novo atributo significa consultar apenas três coisas na referência da API: o nome do elemento filho, o seu tipo de dados e os seus valores permitidos.
Se você consegue reunir um pai e um filho, a parte mais difícil desta configuração já ficou para trás. O que resta é informar ao seu provedor de identidade de onde cada valor deve vir — abordado nas seções do Entra ID e da Okta a seguir — e decidir quais atributos abordar primeiro, abordado a seguir.
Dois tipos de mapeamento: básico e avançado
Nem todo atributo apresenta o mesmo risco, e vale a pena classificá-los antes de Configurar qualquer coisa.
Este guia empresta os termos básico e avançado do Guia de Campo SSO, que traça a mesma linha para o mapeamento de respostas SAML. Os termos descrevem o que o Zoom faz com o valor na chegada, não quão difícil é Configurar o atributo. Mecanicamente, os dois são idênticos: ambos são documentados no mesmo Atualizar um usuário corpo da solicitação, ambos são construídos com a mesma estrutura pai-dois-pontos-filho, e ambos são declarados e mapeados pelos mesmos passos no Entra ID e no Okta.
mapeamento básico escreve texto no perfil de um usuário. O Zoom armazena o valor exatamente como foi enviado e nunca o verifica em relação a nada.
mapeamento avançado faz uma reivindicação sobre a conta. O Zoom pega o valor e procura um objeto correspondente, ou um assento livre em um plano adquirido — e essa pesquisa pode falhar.
Qual é o valor
Texto armazenado no perfil do usuário
Um ponteiro para um objeto no Zoom, ou uma reivindicação sobre um assento adquirido
Exemplos
department, título, centro de custo
zoomPhoneSite, zoomContactCenterRole, zoomWorkplace
Pai
Nível superior, ou a extensão empresarial
A extensão Zoom
Pré-condições no Zoom
Nenhum
O objeto deve existir, ou o assento deve estar livre
Se o valor estiver errado
Texto incorreto aparece em um perfil
O atributo é rejeitado ou ignorado silenciosamente
A distinção orienta duas decisões práticas. Ela determina o que você deve construir primeiro no Zoom — nada para o mapeamento básico, potencialmente muito para o avançado — e ela determina o custo de um erro. Um departamento incorreto é um erro cosmético em um perfil. Um nome de unidade incorreto ou um assento de licença indisponível deixa um usuário sem um telefone funcionando ou sem o produto que ele foi contratado para usar e, em uma implantação em produção, pode retirar um direito de alguém que já o possuía.
Essa diferença de consequência é o motivo pelo qual os dois são tratados separadamente abaixo.
Mapeamento básico: informações de perfil
O mapeamento básico preenche os campos descritivos no perfil de Zoom de um usuário. O Zoom armazena cada valor exatamente como enviado e nunca o valida em relação a um objeto existente, portanto não há nada para criar no Zoom previamente e nada para quebrar se um valor estiver errado.
Os campos principais de identidade normalmente já estão mapeados. Nome de usuário, name.givenName, name.familyName, displayName, e emails ficam no nível superior do corpo da solicitação, sem nenhum pai, e tanto as integrações do Entra ID quanto do Okta os mapeiam prontos para uso. Verifique-os em vez de recriá-los. título, números de telefone, e localidade também são de nível superior, mas podem precisar de ser adicionados.
Os campos empresariais usam um segundo pai. A construção não Alterar — apenas o pai faz:
O preenchimento de Departamento e Centro de Custo através de SCIM já não requer mapeamento SAML.
Mapeamento avançado: configuração do produto e direitos
O mapeamento avançado atribui o que um usuário pode fazer: uma unidade do Zoom Phone e um Plano de tarifação de chamadas, uma Função e Pacote de central de contato, um Pacote do Workplace, um segmento do Revenue Accelerator. Esses atributos ficam sob a extensão Zoom principal usada ao longo deste guia.
A diferença que importa é que estes valores não são armazenados — eles são resolvido. O Zoom pega o valor que você envia e procura um objeto correspondente ou um assento disponível. Onde o mapeamento básico escreve texto em um perfil, o mapeamento avançado faz uma reivindicação sobre a configuração e o inventário da conta, e essa reivindicação pode falhar.
É por isso que este guia dedica uma seção inteira aos pré-requisitos. Todo atributo avançado depende de algo ter sido construído ou comprado primeiro no Portal web do Zoom, e os modos de falha são consideravelmente menos tolerantes do que um cargo digitado incorretamente.
As três camadas comuns a toda configuração
Independentemente de qual atributo ou de qual provedor de identidade, o trabalho é o mesmo em três camadas. Apenas a Localização de cada controle difere.
1. Declarar
Diga ao provedor de identidade que o atributo existe no aplicativo Zoom para que ele fique disponível como um alvo de mapeamento.
Etapa 1
Etapa 1
2. Mapeamento
Defina de onde o valor vem.
Etapa 2
Etapas 2–3
3. Escopo
Determine a quais usuários a configuração se aplica e quando ela é executada.
Etapas 3–5
Etapas 4–5
Assim que esse padrão for compreendido, adicionar um quinto ou décimo quinto atributo é uma repetição das mesmas três camadas, não um novo projeto.
Entra e Okta diferem em onde um valor pode se originar
Esta é a diferença arquitetônica mais consequente entre os dois caminhos, e ela explica por que o mesmo requisito Corporativo produz configurações diferentes entre Entra e Okta.
Entra ID obtém valores apenas dos atributos do objeto de usuário. Um valor deve vir de um campo no usuário — um campo de diretório existente ou um atributo de extensão feito sob medida. Quando o valor do diretório e o valor do Zoom não são a mesma string, é necessária uma expressão para traduzir entre eles.
O Okta pode obter valores do perfil do usuário ou de uma atribuição de grupo. Declarar um atributo com Tipo de atributo: grupo permite que o valor seja definido uma vez em um grupo e herdado por todos os Membros. Quando a configuração segue a estrutura organizacional, isso elimina totalmente a necessidade de lógica de tradução.
Nenhuma das abordagens é universalmente melhor, mas elas levam a configurações diferentes.
Requisitos de pré-configuração do lado do Zoom
Antes de tentar o mapeamento avançado, os objetos do lado do Zoom devem existir antes que o SCIM possa referenciá-los
O SCIM é um mecanismo de atribuição, não um mecanismo de criação — ele conecta um usuário à configuração que já existe na conta Zoom, e ele não pode constrói essa configuração em nome do usuário.
Uma grande parte dos atributos de mapeamento avançado são referências: o valor que você envia deve se resolver em um objeto que já existe no Zoom — uma unidade, uma função, um modelo, um plano comprado, um número específico ou número do ramal. Uma única regra governa todos eles:
Se um atributo nomeia algo, essa coisa já deve existir, deve ser escrita exatamente como foi enviada e — quando depende de um pool finito — deve ter capacidade não utilizada.
Quando um objeto referenciado não existe, o SCIM nem o cria nem coloca a solicitação em fila. O atributo falha imediatamente, com o erro retornado no log de provisionamento, ou é descartado silenciosamente — o Zoom aceita a carga útil, não aplica nada e informa sucesso.
As seções abaixo detalham os pré-requisitos por produto, com o caminho de navegação e o artigo de Suporte para construir cada um. Leia as notas no nível da conta e, depois, a seção de cada produto que você pretende provisionar.
Os pré-requisitos no nível da conta se aplicam antes que qualquer produto seja provisionado
Os requisitos da conta listados no início deste guia — URL intuitivo, SSO, autorização SCIM e um domínio associado verificado — são pré-requisitos para cada atributo a seguir. Configurar a segurança e o SSO em Centro de administração → Segurança e confiança, e gerencie Domínios associados em Centro de administração → Conta → perfil da conta; veja configuração de SSO/SCIM do Zoom + Microsoft Entra ID.
Mais dois pontos merecem ser explicitados:
Comprar uma vaga não é o mesmo que atribuí-la. O SCIM executa a atribuição, mas a vaga deve existir primeiro. Veja Atribuindo ou removendo licenças do Zoom dos usuários.
As vagas devem pertencer exatamente ao plano solicitado. Enviar um atributo de licença quando aquele plano específico não tiver vagas livres falha mesmo que um plano diferente na conta mostre capacidade sobrando.
Zoom Phone
O Zoom Phone inclui o maior conjunto de atributos de referência porque um usuário de telefone é montado a partir de várias partes de infraestrutura pré-comprada ou pré-construída.
A licença do Zoom Phone
Uma vaga do Zoom Phone está Disponível — a autorização obrigatória antes que qualquer coisa abaixo possa ser vinculada.
Compre com antecedência. Veja Comprando e atribuindo licenças do Zoom Phone.
zoomPhoneSite
A unidade, nomeada exatamente como o valor enviado. Omitir o atributo atribui a unidade principal da conta, que existe por padrão assim que múltiplas unidades são habilitadas.
Centro do administrador → configuração do produto → sistema de telefonia → Informações da empresa → Adicionar unidade, ou Importar para criação em massa. Veja Gerenciando múltiplas unidades.
zoomPhoneNumber
O número, comprado ou portado para a conta e atualmente não atribuído. Um número já detido por outro usuário, fila de chamadas ou recepcionista automático não pode ser reutilizado.
Centro do administrador → configuração do produto → Números de telefone → Números de telefone. Compre ou porte aqui e deixe o número de destino sem atribuição para que o SCIM possa reivindicá-lo. Veja Usando o Gerenciamento de Números para gerenciar Números de telefone e Gerenciando Números de telefone.
zoomPhoneExtNumber (somente valores específicos)
Um ramal de 3 a 6 dígitos, ainda não em uso. Não é necessário ao enviar 0, que delega a atribuição ao Zoom.
Centro do administrador → configuração do produto → sistema de telefonia → Usuários & Salas → Selecionar o objeto que contém o número do ramal → Perfil → número do ramal → Editar. Ver Alterando as Configurações do usuário de telefone.
zoomPhoneCallingPlan
O Plano de tarifação de chamadas, adquirido e com capacidade Disponível, referenciado pelo seu código exato do plano.
Compre com antecedência. Veja Comprando e atribuindo licenças do Zoom Phone e Gerenciando usuários de telefone. Os códigos de plano estão listados em referência do Plano de tarifação de chamadas do Zoom Phone, ou retornado como tipo pelo Listar o Plano de tarifação de chamadas API juntamente com contagens de assentos Disponível.
zoomPhoneAssinaturaDoPlanoDeChamadas (somente contas com várias assinaturas)
A assinatura específica da qual o plano deve retirar, quando a conta possui mais de uma assinatura do mesmo plano.
Planos e Faturamento → gerenciamento de assinaturas.
O pool de ramais é compartilhado entre tipos de objetos, não apenas usuários. Filas de ligar, atendentes automáticos, grupos de linha compartilhada e telefones de área comum consomem ramais de todo o mesmo intervalo. Esta é a causa mais frequente de falhas de "ramal já em uso" porque o ramal parece livre quando um administrador verifica apenas a lista de usuário.
Um número portado não pode ser atribuído até que a Porta seja concluída. O número deve tanto apresentar na conta quanto estar não atribuído; iniciar uma Porta não satisfaz nenhuma das condições.
Os sites são o bloqueador mais comum porque criá-las implica requisitos próprios. Os endereços da unidade são validados contra uma base de dados de endereços do mundo real porque sustentam serviços de chamada de emergência — combinações inventadas de endereço e código postal são rejeitadas com um erro de validação. Ao importar unidades em massa, a coluna recepcionista automático espera o valor Sim em vez do texto do rótulo mostrado na interface, e nome da ID do chamador aplica-se principalmente aos EUA e ao Canadá e pode ser deixado em branco se causar uma falha de validação.
Zoom central de contato
O provisionamento da central de contato é orientado por Função e por modelo. Os atributos individuais devem corresponder a objetos existentes da central de contato, e o modelo contém as Configurações que não têm um atributo SCIM dedicado próprio.
zoomContactCenterPackage
O Pacote — Essentials, Premium, ou Elite — comprado com assentos não utilizados.
comprar com antecedência; O Premium pode exigir entrar em contato com o Suporte do Zoom para comprar pacotes adicionais primeiro. Veja Alterando as Configurações de usuário da central de contato Zoom.
zoomContactCenterAddonsPlan
O plano add-on, adquirido e com capacidade.
Comprar com antecedência; plano da conta e Informações de faturamento.
zoomContactCenterRole
A Função, padrão ou personalizada, nomeada exatamente. Omiti-la atribui a Função padrão de Agente, que existe por padrão.
Centro de administração → gestão de CX → central de contato → Funções → Adicionar → Configurar permissões → Salvar. Ver Gerenciando Funções do Zoom central de contato.
zoomContactCenterRegion
A região. Omiti-la atribui a região principal da conta, que deve ser configurada.
Centro de administração → gestão de CX → central de contato → Preferências → Regiões → Adicionar Região → Inserir um nome e Selecionar uma Zona SIP → Adicionar. Ver Gerenciando regiões do Zoom central de contato.
zoomCentralDeContatoModeloDeUsuário
O modelo do usuário, nomeado exatamente. Modelos do tipo Adicionar aplicam-se na criação do usuário; modelos do tipo Atualizar aplicam-se na atualização.
Centro de administração → gerenciamento de CX → central de contato → usuários → Modelos → Adicionar modelo → Escolher Adicionar → Configurar funções, pacotes, filas e habilidades → Adicionar. Ver Gerenciamento do modelo de Configurações de usuário da central de contato Zoom.
Caixas de entrada, filas e habilidades não têm atributo SCIM. Para provisioná-los, crie-os previamente em Centro de administração → gestão de CX → central de contato, anexá-los a um modelo de usuário e Atribuir esse modelo por meio de zoomCentralDeContatoModeloDeUsuário. Eles, portanto, tornam-se pré-condições do modelo em vez de do usuário individual — o que também torna o modelo o único objeto a manter à medida que esses requisitos sofrem Alterar.
Fila
Centro de administração → gestão de CX → central de contato → Filas → Adicionar fila → nome, canal, agentes → Salvar. Ver Gerenciando filas do Zoom central de contato.
Habilidade
Centro de administração → gestão de CX → central de contato → Habilidades → Selecionar uma categoria → Adicionar Habilidade → nome → Adicionar. Ver Gerenciando habilidades e categorias de habilidades.
Caixa de entrada
Centro de administração → gestão de CX → central de contato → Caixa de entrada → Adicionar Caixa de entrada. Ver Gerenciando caixas de entrada do Zoom central de contato.
Quando um modelo e atributos individuais são fornecidos, os valores individuais prevalecem. Enviando um modelo juntamente com zoomContactCenterRole significa que o atributo de Função substitui a configuração de Função do modelo, portanto, tanto a Função referenciada quanto o modelo devem existir.
Zoom Revenue Accelerator
zoomRevenueAcceleratorPlan e zoomRevenueAcceleratorSubscription
O plano ou assinatura ZRA adquirido com um assento Disponível.
Comprar com antecedência; plano da conta e Informações de faturamento.
zoomRevenueAcceleratorFunção
A Função, padrão ou personalizada — por exemplo Gerente de Vendas — nomeado exatamente.
Centro de administração → Usuários → Funções → Revenue Accelerator aba → + Adicionar Função → nome e descrição → Adicionar → Configurar permissões → Salvar alterações. Ver Usando o Gerenciamento de função do Zoom Revenue Accelerator.
zoomRevenueAcceleratorSegmento
O segmento ao qual o usuário pertence.
Configurações de administrador do Revenue Accelerator.
zoomRevenueAcceleratorRegion
A região — por exemplo, EUA.
Configurações de administrador do Revenue Accelerator.
Licenças do Zoom Workplace e Função da conta
Além dos três produtos acima, o gravar padrão do usuário carrega referências de Função e licença que seguem a mesma regra.
Função[] (valor / Exibir)
A Função da conta, nomeada exatamente. As Funções são referenciadas pelo SCIM, nunca criadas por ele.
Centro de administração → Usuários → Funções → Adicionar Função → nome e descrição → Configurar permissões. Veja Usando Gerenciamento de função.
zoomWorkplace e outros atributos de licença ou add-on — quadro de compartilhamento, Scheduler, Clips Plus, legendas traduzidas, Workforce Management (WFM), Gestão da Qualidade, Gestão da conformidade, CX Insights, Assistente de Vendas com IA e seus ...Assinatura contrapartes
O pacote ou add-on correspondente, adquirido com assentos não utilizados.
Planos e Faturamento → Gestão de Planos → edite o plano → aumente o número de licenças. Veja A atualizar a sua conta e complementos.
tipo de login (sso / emailProfissional), sob urn:us:zoom:scim:schemas:extension:1.0:ZoomUser
SSO configurado na conta, para o tipo de login SSO.
Centro de administração → Segurança e confiança → logon único.
Para um atributo de licença ou add-on, não há objeto a nomear, mas a pré-condição tem o mesmo efeito: sem uma vaga Disponível nesse pool específico, a atribuição falha.
Atributos sem pré-condição
Todo atributo básico de mapeamento é elegível, conforme abrangido em Mapeamento básico: informações de perfil — Zoom armazena esses valores literalmente e nunca os valida em relação a um objeto existente. Dois atributos na extensão Zoom se comportam da mesma maneira:
Valores autodelegados —
zoomPhoneExtNumberenviados como0, em que o Zoom atribui a extensão por conta própria.Atributos personalizados da conta — o
{customAttribute}campo, que contém qualquer string que você enviar.
Referências com padrão são um caso intermediário: omitir zoomPhoneSite, zoomContactCenterRole, ou zoomContactCenterRegion reverte para a unidade principal, a Função de Agente padrão e a região principal, respectivamente. Esses padrões precisam existir por si mesmos, e existem por padrão.
Grupos são uma exceção parcial. Quando o provisionamento de grupo está ativado, o SCIM criará um grupo do Zoom que ainda não existe, usando o nome do grupo de origem exatamente como foi digitado. Ele não aplica nenhuma configuração de produto a esse grupo — o grupo chega com membros e nada mais. As políticas do Zoom Phone, as permissões de chamadas e outras Configurações no nível do grupo ainda devem ser configuradas em Centro de administração → Usuários → Grupos depois que o grupo aparecer.
Preparando os dados do seu diretório
O SCIM transmite exatamente o que a origem contém. Ele não valida, normaliza nem corrige. Antes de mapear qualquer atributo, confirme três coisas sobre a origem pretendida:
Ele está preenchido para cada usuário no escopo. Um campo não preenchido não envia nada ou envia o padrão configurado.
Seus valores são consistentes em formato e capitalização. A lógica de comparação em ambos os provedores de identidade é exata.
Os respetivos valores coincidem exatamente com os valores esperados do Zoom. O Zoom não faz correspondência aproximada de nomes de unidade, nomes de Função ou valores de plano.
Quando um campo existente não consegue satisfazer todas as três condições, um atributo feito sob medida e preenchido deliberadamente para estas Integrações é mais sustentável do que reaproveitar um campo para o qual também escrevem outros sistemas.
Cenários de Referência
Quatro cenários são usados ao longo deste guia. Os respetivos requisitos empresariais e pré-requisitos do lado do Zoom são idênticos, independentemente do fornecedor de identidade, pelo que são definidos aqui uma única vez. Cada secção específica do fornecedor de identidade termina mostrando como implementar os quatro nessa plataforma.
Cenário 0: Departamento, como um primeiro mapeamento básico
O departamento de um usuário deve aparecer no respetivo perfil do Zoom, tendo como origem o diretório. Este é o mapeamento básico recomendado anteriormente como um primeiro teste de ponta a ponta, e está incluído aqui para que o procedimento seja percorrido nas secções de ambos os fornecedores de identidade.
Pré-requisito do lado do Zoom. Nenhum. O Zoom armazena o valor exatamente como foi enviado e nunca o valida em relação a um objeto existente.
Atributo. Note que o pai difere dos três cenários abaixo — department reside sob a extensão empresarial, não a extensão Zoom.
urn:ietf:params:scim:schemas:extension:empresarial:2.0:usuário:departamento
string
Texto livre. Ambos os provedores de identidade já contêm um department campo no perfil do usuário, portanto nenhum novo atributo de origem é necessário.
Por que começar aqui. Um valor de departamento que aparece corretamente em um perfil do Zoom comprova a declaração do esquema, o mapeamento, o escopo e sua capacidade de ler os registros de provisionamento — sem colocar uma licença ou uma configuração do telefone em risco. Cada cenário avançado abaixo difere apenas no que o atributo aponta.
Verifique primeiro se já está mapeado. Os mapeamentos padrão diferem entre o Entra ID e o Okta, e Alterar à medida que ambos os fornecedores atualizam as suas integrações com o Zoom. Reveja a lista existente em Provisionamento → Mapeamentos no Entra, ou Mapeamentos de Atributos do Zoom com Mostrar Atributos Não Mapeados ativado no Okta. Se department já estiver mapeado, verifique-o em vez de declarar uma duplicata — e, se você quiser um atributo para Configurar do zero em vez disso, centro de custo, Organização, e employeeNumber ficam sob o mesmo pai e comportam-se de forma idêntica.
Cenário 1: unidade do Zoom Phone e atribuição automática de ramal
Os utilizadores devem ser colocados na unidade correta do Zoom Phone com base no seu escritório e receber um número do ramal sem intervenção administrativa.
Pré-requisito do lado do Zoom Os sites já devem existir. Crie-os abaixo de Centro do administrador → Configuração do produto → sistema de telefonia → Informações da empresa → Adicionar unidade, ou em massa através de Importar. Os endereços da unidade são validados contra uma base de dados de endereços do mundo real porque suportam serviços de chamada de emergência, por isso combinações fictícias de endereço e código postal falharão na validação.
Atributos. Ambos usam o namespace urn:ietf:params:scim:schemas:extension:zoom:1.0:Usuário: seguido pelo nome.
zoomPhoneSite
string
Deve corresponder ao nome da unidade do Zoom caractere por caractere
zoomPhoneExtNumber
string
0 aciona a atribuição automática
Por que o valor 0 importa. Zoom é o único sistema que sabe quais ramais já estão em uso — incluindo ramais atribuídos a filas de ligação e recepcionistas automáticos, em vez de usuários. Delegar a atribuição ao Zoom remove toda uma categoria de falha de provisionamento. Obter os ramais do diretório em vez disso é apropriado durante uma migração, quando preservar os números de ramal existentes importa, mas o mapeamento deve mudar para 0 assim que a migração for concluída, para que os novos usuários não dependam de os dados do diretório serem mantidos indefinidamente.
Cenário 2: Plano de tarifação de chamadas do Zoom Phone variando por país
Uma Organização multinacional adquiriu o Plano de tarifação de chamadas do Zoom Phone e precisa que cada usuário receba o plano correspondente ao seu país.
Pré-requisito do lado do Zoom. Os planos de tarifação de chamadas já devem ter sido comprados e estar disponíveis na conta. Os valores do plano estão documentados em referência do Plano de tarifação de chamadas do Zoom Phone.
Atributo. zoomPhoneCallingPlan (string).
Como obter o código correto do plano. zoomPhoneCallingPlan usa o código numérico do plano, e não o nome de um plano. A maneira mais confiável de obtê-lo é a Listar o Plano de tarifação de chamadas API, que retorna o nome de cada plano nome, o seu tipo — o código que você mapeia — e o seu subscrito e disponível contagens de assentos. Uma chamada (ligar), portanto, confirma que o plano existe, fornece o valor a enviar e verifica se há capacidade para Atribuir-lo.
O Portal web do Zoom mostra apenas nomes de Exibir, nunca códigos, então um administrador que trabalha apenas a partir do portal deve traduzir o nome de Exibir usando o referência do Plano de tarifação de chamadas do Zoom Phone — onde, por exemplo, UNLIMITED_PLAN_US_CA é 200 e UNLIMITED_PLAN_GB_IE é 202. A referência lista nomes de constantes em vez da redação do portal, portanto confirme a correspondência nas características do plano — região e medido versus ilimitado — em vez do texto exato.
Separadamente, a referência da API SCIM2 do Zoom mostra um nome de plano de Faturamento como phone_calling_usca_monthly_unlimited em sua carga útil de exemplo. Esse identificador é usado para comprar uma assinatura, não para atribuir um plano a um usuário. Se você precisar especificar de qual assinatura um plano se origina, isso pertence em zoomPhoneAssinaturaDoPlanoDeChamadas.
Por que -1 é usado como fallback. Os documentos de referência do SCIM2 -1 como o valor que remove todos os planos de chamadas. Usá-lo para usuários sem correspondência produz um resultado determinístico e visível — nenhum plano atribuído — em vez da ambiguidade de não enviar valor algum. Ele também oferece uma maneira limpa de remover os direitos de chamadas sem excluir o usuário.
Cenário 3: Pacote, Função e região da central de contato Zoom
Os agentes da central de contato devem ser provisionados com o Pacote ZCC e a Função corretos no momento da Integração, em vez de configurados manualmente depois. Este cenário demonstra que o método é independente do produto — nada no procedimento muda, apenas os nomes dos atributos e os valores permitidos.
zoomContactCenterPackage
string
Essentials, Premium, Elite
zoomContactCenterRole
string
Qualquer nome de Função do ZCC. O padrão é Agente se omitido.
zoomContactCenterRegion
string
Qualquer região do ZCC configurada. O padrão é a região principal se omitida.
Ao omitir atributos deliberadamente. Sair/sair zoomContactCenterRegion não mapeado em implantações de região única, onde o padrão documentado do Zoom já está correto. Omitir um atributo cujo padrão está correto é preferível a mapeá-lo — cada mapeamento é uma obrigação de manutenção.
Nota operacional. A referência SCIM2 também documenta zoomCentralDeContatoModeloDeUsuário, que aplica um modelo ZCC pré-construído. Modelos do tipo Adicionar aplicam-se na criação do usuário e modelos do tipo atualização aplicam-se na atualização; quando tanto um modelo quanto valores individuais de atributo são fornecidos na mesma solicitação, os valores individuais têm prioridade. Vale considerar modelos quando a configuração do ZCC é complexa o suficiente para que mantê-la em muitos mapeamentos individuais de atributos se torne difícil.
Verificação do lado do Zoom e erros comuns
Cada provedor de identidade tem seu próprio log, coberto na Etapa 6 de cada provedor de identidade. O log do Zoom abaixo é idêntico para ambos e é o gravar definitivo do que o Zoom realmente recebeu.
Os logs de ligar do Zoom App Marketplace Mostrar a troca completa de solicitação e resposta
Iniciar sessão no Portal web do Zoom como o proprietário da conta.
Navegue até a Zoom App Marketplace → Gerenciar → Apps na conta.
Selecionar o aplicativo que representa a conexão com o provedor de identidade. No Entra, isso normalmente é chamado Identidade do Azure ou similar.
Abra o Registos de ligar aba.
Usar Pesquisar por pontos de extremidade, ou pelos filtros de intervalo de datas, método e status, para localizar a ligação relevante.
Selecionar a linha para expandi-la.
Revisar
corpo da solicitaçãopara ver exatamente o que foi enviado, erespostapara ver exatamente o que o Zoom retornou, incluindo o ID de usuário do Zoom gerado,status HTTP, e o conjunto de atributos resultante.
O Zoom mantém os 100 registros de solicitações de API mais recentes, portanto investigue uma falha prontamente, e não depois que outra atividade de provisionamento a tenha substituído.
Erros comuns de provisionamento e suas causas
400
A conta não habilitou o logon único.
SSO é um pré-requisito para SCIM. Habilitar e Configurar o SSO na conta Zoom primeiro.
400
O usuário está inativo ou bloqueado.
O usuário do Zoom de destino não pode ser atualizado em seu estado atual. Resolva o estado da conta no Portal web do Zoom.
403
A solicitação foi negada devido a permissões insuficientes: "usuário:Edit".
As credenciais por trás da conexão SCIM não têm o escopo necessário. Reautorize a conexão com uma conta de Proprietário ou administrador.
404
O usuário não existe.
O provedor de identidade não correlacionou o usuário a um usuário Zoom existente. Verifique o atributo de correspondência e o formato do Nome de usuário.
409
O domínio de e-mail não corresponde ao domínio associado da conta.
O domínio de e-mail do usuário não está associado à conta Zoom. Associe e verifique o domínio antes do provisionamento.
409
Não é possível adicionar usuários pagos.
Não há licença do tipo solicitado disponível. Liberte capacidade na conta ou provisione o usuário como básico.
409
Não é possível criar mais usuários com [nome do pacote].
O pacote específico não tem assentos restantes. Aplica-se ao Workplace Corporativo Plus, empresarial Premier, Pro Plus e aos equivalentes de Educação.
429
Muitas solicitações.
O provisionamento excedeu os limites de taxa do Zoom. Investigue se isso persistir ao longo dos ciclos.
Um modo de falha não produz erro algum
Um valor que o Zoom aceita, mas que não corresponde a nada — um nome de unidade com um espaço no final, ou um nome de Função que desde então foi renomeado no Zoom — pode ser aceito sintaticamente e não ser aplicado a nada. Nenhuma entrada de log sinaliza essa ocorrência. As variantes específicas de plataforma do mesmo problema são abordadas na Etapa 6.
Configurando o SCIM com Entra ID
Requisitos adicionais para o Entra ID
Privilégios de administrador do Entra ID com acesso a Aplicativos empresariais
O domínio de e-mail usado pelos seus usuários verificado como um domínio personalizado no locatário do Entra ID
Limitações adicionais no Entra ID
Os mapeamentos de atributos têm origem exclusivamente no Entra objeto de usuário atributos. Os grupos de segurança não podem fornecer um valor diretamente a um atributo do Zoom; a associação ao grupo controla o escopo, não o valor.
Os ciclos incrementais de provisionamento são executados aproximadamente a cada 40 minutos. As alterações não são instantâneas depois que o provisionamento é ativado.
O
Colaboraçãovalor detipo de utilizadornão é compatível com o Entra ID devido a uma limitação específica da Microsoft.
Etapa 1: Declare o atributo no esquema do aplicativo Zoom
Declarar um atributo é uma ação única por atributo. Declare todos os atributos que pretende usar antes de configurar quaisquer mapeamentos, para que todos os alvos estejam disponíveis na Etapa 2.
Inicie sessão no Portal do Azure usando o URL do editor de esquema:
https://portal.azure.com/?Microsoft_AAD_Connect_Provisioning_forceSchemaEditorEnabled=true#homeEm Serviços do Azure, Selecionar Microsoft Entra ID.
No menu de navegação à esquerda, em Gerenciar, clique Aplicativos empresariais.
Na lista de aplicativos, clique no seu aplicativo Zoom. Nota: O nome do aplicativo é definido pelo administrador do Entra quando o aplicativo é criado. Geralmente é chamado de Zoom ou Zoom SSO, mas pode ser diferente no seu locatário.
No menu de navegação à esquerda, em Gerenciar, clique Provisionamento. Nota: O Azure atualmente apresenta um de dois layouts. Na experiência legada, selecione Editar mapeamentos de atributos em Gerenciar provisionamento. Na experiência mais recente, a página é aberta em uma Visão geral aba; selecione Provisionamento novamente no menu à esquerda. Ambos os caminhos chegam ao mesmo destino.
Clique em Mapeamentos menu suspenso, depois clique em Provisionar Utilizadores do Microsoft Entra ID. Nota: Em inquilinos que ainda exibem nomenclatura legada, esta opção aparece como Provisionar usuários do Azure Active Directory.
No canto inferior esquerdo, Selecionar o Mostrar opções avançadas caixa de seleção.
Clique Editar lista de atributos para Zoom.
Desloque-se até à primeira linha vazia e complete o seguinte:
Nome: Inserir a cadeia de atributos completa, por exemplo
urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSiteTipo: Selecionar Cadeia de caracteres ou Booleano, correspondendo ao tipo de dados documentado na referência da API SCIM2.
Repita o passo 9 para cada atributo adicional.
No canto superior esquerdo, clique Salvar.
Passo 2: Mapear uma origem de diretório para o atributo
O Entra ID oferece três tipos de mapeamento, e a escolha entre eles é a decisão mais importante na configuração.
Direto
Um campo do Entra já contém o valor exato que o Zoom espera.
Passa o valor de origem sem alterações.
Constante
Todo usuário no escopo deve receber o mesmo valor.
Envia um valor fixo para cada usuário provisionado.
Expressão
O valor deve ser derivado, traduzido ou variado por atributo do usuário.
Avalia uma expressão em relação aos campos de origem e envia o resultado.
Para criar o mapeamento:
Voltar para Provisionamento → Mapeamentos → Provisionar Utilizadores do Microsoft Entra ID.
No canto inferior esquerdo, clique Adicionar Novo Mapeamento.
Configurar o mapeamento de acordo com o tipo selecionado — consulte a orientação abaixo.
Clique em Atributo de destino menu suspenso e Selecionar o atributo declarado na Etapa 1.
Clique em Corresponder objetos usando este atributo menu suspenso e Selecionar Não. NotaOs atributos personalizados do Zoom são valores de configuração, não chaves de correspondência de identidade. Apenas o atributo que correlaciona utilizadores do Entra com utilizadores do Zoom — normalmente
Nome de usuário— deve ser definido como Sim.Clique em Aplicar este mapeamento menu suspenso e Selecionar Sempre, de modo que o valor se aplica tanto na criação quanto nas atualizações subsequentes.
Clique OK.
Repita para cada atributo e depois clique Salvar na parte superior do Mapeamento de atributos página.
O mapeamento direto passa um campo existente sem transformação
Tipo de mapeamento: Direto
Atributo de origem: Um campo do Entra cujo valor já corresponde exatamente ao que o Zoom espera, caractere por caractere
Valor padrão se nulo (Opcional): Uma alternativa aplicada quando o campo de origem está vazio
O mapeamento direto é a opção menos frágil e deve ser preferido sempre que os dados do diretório o permitirem. Se physicalDeliveryOfficeName — apresentado como Localização do escritório no perfil de usuário do Entra — já contém valores que correspondem exatamente aos nomes das unidades do Zoom Phone, mapeá-lo diretamente não requer nenhuma lógica.
O mapeamento constante aplica um valor a toda a população no escopo
Tipo de mapeamento: Constante
Valor constante: O valor fixo a ser enviado
O mapeamento constante é adequado para implantações de configuração única e também é o mecanismo por trás de vários comportamentos específicos do Zoom. Definir zoomPhoneExtNumber para um valor constante de 0 instrui o Zoom a Atribuir o Próximo(a) ramal Disponível dentro da unidade do usuário, eliminando completamente conflitos de ramal.
O mapeamento por expressão traduz ou deriva um valor no momento do provisionamento
Tipo de mapeamento: Expressão
Expressão: Uma expressão aninhada
IIF()instrução que avalia um ou mais atributos de origem
O mapeamento por expressão é necessário sempre que o valor do diretório e o valor do Zoom não forem a mesma string:
Envolva os valores de origem em ToUpper() e compare com literais em maiúsculas para neutralizar inconsistências de maiúsculas e minúsculas:
O formato do campo de origem varia conforme como o usuário do Entra foi criado
Esta é a causa mais comum de mapeamentos por expressão que parecem corretos, mas se comportam de forma inconsistente em uma população.
Localização de uso é imposto pela Microsoft para sempre conter um código ISO 3166-1 alfa-2 válido, como
GB, porque rege a disponibilidade da licença e dos Recursos. Este campo é confiável.País ou região não impõe essa validação, e seu conteúdo depende do método de criação. Usuários criados por meio da interface gráfica do portal de administração do Entra selecionam em uma lista suspensa de nomes completos de países, portanto o campo normalmente armazena
Reino Unido. Usuários criados por importação de CSV ou PowerShell geralmente são preenchidos comGB— por convenção, não por validação.
Em qualquer tenant em que usuários tenham sido criados por mais de um método, país não manterá um formato consistente. Padronize o campo antes de criar a expressão ou teste explicitamente ambos os formatos, como mostrado acima.
Etapa 3: Inclua usuários e grupos no escopo de provisionamento
A atribuição determina quais usuários a configuração afeta. Usuários fora do escopo de atribuição do aplicativo nunca são afetados por nenhum mapeamento, o que torna a atribuição o principal controle de segurança durante a implantação.
Navegue para Microsoft Entra ID → Aplicativos empresariais → seu aplicativo Zoom → Usuários e grupos.
Clique Adicionar usuário/grupo.
Em Usuários e grupos, selecione o usuário ou grupo de segurança desejado.
Em Selecione uma função, escolha a função apropriada.
Clique Atribuir.
Na prática, apenas dois valores de função importam. Outras opções como Corp e Pro são nomenclaturas legadas que estão sendo descontinuadas ou destinadas a cenários incomuns.
básico
Provisiona o usuário sem uma licença paga de reunião. Selecione isto quando um atributo personalizado — como um Plano de tarifação de chamadas do Zoom Phone — for responsável por atribuir a licença paga.
Licenciado
Atribui o plano de licença da conta Zoom padrão plano de licença, por exemplo Zoom Workplace empresarial Plus. Esta tela não permite escolher um pacote específico; o padrão é configurado do lado do Zoom.
Essa seleção de função se aplica uma vez por usuário ou grupo adicionado ao aplicativo, independentemente de quantos atributos personalizados estejam sendo provisionados.
Para provisionar grupos do Entra como grupos Zoom, que está desativado por padrão:
Navegue para Provisionamento → Mapeamentos e Selecionar Provisionar grupos do Microsoft Entra ID.
Alternar Ativado para Sim.
Confirme se os mapeamentos padrão estão em vigor:
displayName→displayName, emembros→membros.Clique Salvar.
Voltar para Usuários e grupos e confirme se o próprio grupo está atribuído ao aplicativo, não apenas seus membros individuais. O provisionamento de grupos processa apenas grupos atribuídos diretamente.
Etapa 4: valide com Provisionamento sob demanda
Provisionamento sob demanda funciona independentemente do Status de provisionamento o Alternar, razão pela qual é a ferramenta correta para validação. Todas as etapas até este ponto — incluindo esta — podem ser concluídas enquanto o provisionamento permanece desativado.
Navegue para Provisionamento → Visão geral do provisionamento.
Clique Provisionamento sob demanda.
Pesquise e selecione um único usuário de teste e, em seguida, clique Provisionamento.
Revise o resultado. O Entra relata as quatro etapas que executa para cada Evento de provisionamento — Importar, Determinar se está no âmbito, Corresponder, e Provisionamento — cada uma expansível individualmente.
Confirme se os valores dos atributos mostrados correspondem à sua intenção.
Iniciar sessão no Portal web do Zoom e confirmar que a configuração foi aplicada.
Etapa 5: Habilitar o provisionamento contínuo
Habilitar o provisionamento coloca a configuração em vigor ao vivo para cada usuário no escopo. Conclua e verifique primeiro as Etapas 1 a 4.
Navegue para Microsoft Entra ID → Aplicativos empresariais → seu aplicativo Zoom → Provisionamento → Provisionamento.
Alternar Status de provisionamento para Ativado.
Clique Salvar.
O primeiro ciclo pode levar até aproximadamente 40 minutos. Os ciclos incrementais subsequentes são executados em intervalos de cerca de 40 minutos. Novos participantes, alterações de atributos e desativações são sincronizados nessa Agendar, em vez de imediatamente.
Etapa 6: Verificar usando os logs de provisionamento do Entra
Navegue para Microsoft Entra ID → Aplicativos empresariais → seu aplicativo Zoom → Monitorar → Logs de provisionamento.
Pesquise ou filtre pelo usuário de teste, depois, Selecionar o Evento relevante. A visualização de detalhes se abre com quatro abas: Passos, Solução de problemas e recomendações, Propriedades modificadas, e Resumo.
Revise o Resumo para confirmar se a ação foi bem-sucedida ou falhou.
Se falhou, abra Solução de problemas e recomendações, que exibe a ação tentada, o nome principal do usuário afetado e — sob Detalhes — o código de erro e a mensagem de erro completa retornados pela API do Zoom.
Esta opção é mais fiável do que inspecionar a tela de mapeamento, porque mostra os valores literais transmitidos, e não aquilo que o mapeamento deveria produzir. Quando o registo do Entra não for conclusivo, consulte os registos de ligar do Zoom App Marketplace descritos em Verificação do lado do Zoom e erros comuns, que Mostrar a troca bruta de solicitação e resposta.
Integração e comportamento de desligamento no Entra ID
O escopo é o principal controle de segurança. Os usuários fora do escopo de atribuição do aplicativo nunca são modificados por qualquer mapeamento nesta configuração.
Desativar um usuário no Entra, ou removê-lo do escopo, reverte o provisionamento automaticamente e fecha o ciclo de desativação.
Cada falha produz uma entrada de registo correspondente — com a ressalva de falha silenciosa mencionada acima.
Passo 7: Aplique os cenários de referência no Entra ID
Os cenários, pré-requisitos e definições de atributos estão na Cenários de referência seção. Aqui são fornecidos apenas os mapeamentos do Entra.
Cenário 0 — Departamento. No Passo 1, declare urn:ietf:params:scim:schemas:extension:empresarial:2.0:usuário:departamento como Cadeia de caracteres, tendo o cuidado de usar o namespace empresarial em vez do namespace do Zoom. Mapeie-o como Direto do Entra department campo. Não Valor padrão se nulo é necessário — um campo de origem vazio simplesmente não envia nada, e nenhum objeto do lado do Zoom precisa existir.
Cenário 1 — unidade do Zoom Phone e extensão automática. Mapear zoomPhoneSite como Direto de physicalDeliveryOfficeName, com Valor padrão se nulo definido como Unidade principal. Mapear zoomPhoneExtNumber como Constante com um valor de 0 a menos que esteja migrando uma configuração preexistente de extensões. Quando os valores de Localização do escritório não corresponderem exatamente aos nomes das unidades do Zoom, substitua uma Expressão mapeamento no formato mostrado na Etapa 2.
Cenário 2 — Plano de tarifação de chamadas variável por país. Como o Entra não consegue obter um valor de um grupo, é necessária uma expressão. Estenda-a com camadas adicionais IIF() por país e considere os formatos alpha-2 e de texto completo, conforme descrito na Etapa 2:
Quando o atributo Plano de tarifação de chamadas atribuir o direito pago, Selecionar básico em vez de Licenciado na Etapa 3. Selecionar Licenciado aplica também a licença padrão da conta, o que pode não ser o resultado comercial pretendido.
Cenário 3 — Pacote da central de contato, Função e região. Mapear zoomContactCenterPackage com um Expressão orientado por um campo de diretório que diferencia os níveis de agente e zoomContactCenterRole como Direto de um campo que contém o nome da Função. Sair/sair zoomContactCenterRegion não mapeado em implantações de região única.
Configurando o SCIM com o Okta
Requisitos adicionais para o Okta
Privilégios de administrador do Okta com Acessar ao Editor de Perfil
Limitações adicionais no Okta
Quando um usuário pertence a vários grupos que fornecem valores conflitantes para o mesmo atributo, somente o valor do grupo de maior prioridade é transmitido. Consulte a Etapa 5.
Etapa 1: Declare o atributo no perfil de usuário do aplicativo Zoom
Este é o atributo que realmente transmite um valor para o Zoom. Declará-lo é uma ação única por atributo.
Iniciar sessão no painel de administração do Okta.
No menu de navegação à esquerda, clique Aplicativos, depois clique em Aplicativos.
Em STATUS, clique ATIVO.
Clique em Zoom aplicativo. Nota: O nome do aplicativo é definido pelo administrador do Okta quando o aplicativo é criado. Ele é frequentemente denominado Zoom, mas pode ser diferente no seu locatário.
Clique em Provisionamento aba.
Em Mapeamentos de Atributos do Zoom, clique Acessar o Editor de Perfil.
Em Atributos, clique + Adicionar atributo.
Conclua o seguinte:
Tipo de dados: Selecionar string ou booleano, correspondente à referência da API SCIM2.
Nome de Exibir: Inserir o nome do atributo, por exemplo
zoomPhoneSite.Nome da variável: Inserir o mesmo nome.
Nome externo: Inserir o nome do atributo exatamente como documentado pelo Zoom, por exemplo
zoomPhoneSite.Namespace externo: Inserir
urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSiteDescrição (Opcional): gravar por que o atributo existe e de onde vêm seus valores.
Tipo de atributo: Selecionar Pessoal para um valor por usuário, ou grupo para um valor herdado por meio da associação ao grupo.
Clique Salvar, ou Salvar e Adicionar outro.
Etapa 2: Crie um atributo de origem no perfil do usuário Okta
Conclua esta etapa em que o valor é mantido por usuário. Ignore-a se o valor for idêntico para cada usuário, ou se for fornecido no nível de grupo em vez disso.
No menu de navegação à esquerda, clique Diretório, depois clique em Editor de Perfil.
Clique em Usuários aba.
No Usuários caixa, abaixo de Filtros, clique Todos.
À direita de Okta, clique em usuário perfil.
Em Atributos, clique + Adicionar atributo.
Conclua o seguinte:
Tipo de dados: Corresponda ao atributo do Zoom declarado na Etapa 1.
Nome de Exibir e Nome da variável: Insira um nome, por exemplo
zoomPhoneSite.Enum (Opcional): Selecionar Defina uma lista enumerada de valores em que o atributo do Zoom aceita apenas um conjunto fixo de valores.
Atributo obrigatório (Opcional): Selecionar Sim em que cada usuário no escopo deve ter um valor.
Clique Salvar.
Use o Enum opção sempre que o Zoom documentar um conjunto fixo de valores — pacotes de central de contato, códigos de pacote do Workplace, valores do plano do Revenue Accelerator. Limitar o campo no momento da entrada evita que um erro de digitação se transforme em uma falha silenciosa de provisionamento que só aparece semanas depois como um direito ausente.
Etapa 3: Mapear o atributo de origem para o atributo do Zoom
Navegue para Aplicativos → Aplicativos → ATIVO → o Zoom aplicativo.
Clique em Provisionamento aba.
Em Mapeamentos de Atributos do Zoom, localize o atributo declarado na Etapa 1 e clique no ícone de edição à sua direita. Nota: Se o atributo não estiver visível, clique Mostrar Atributos Não Mapeados.
Clique em Valor do atributo menu suspenso e Selecionar Mapear do perfil do Okta.
Clique na lista suspensa da origem — que exibe
login | stringpor padrão — e Selecionar o atributo de perfil de usuário do Okta criado na Etapa 2.Selecionar Criar e atualizar. Nota: Criar apenas aplica o valor quando o usuário do Zoom é provisionado pela primeira vez e nunca mais. Selecionar deliberadamente, para valores que não devem ser substituídos após a atribuição inicial; Selecionar Criar e atualizar nos demais casos, para que as alterações no diretório se propaguem.
Clique Salvar.
Repita para cada atributo.
Etapa 4: Habilitar o provisionamento para o aplicativo
Os mapeamentos de atributos não têm efeito até que as operações de provisionamento correspondentes sejam habilitadas. Habilite-as antes de atribuir valores na Etapa 5.
Navegue para Aplicativos → Aplicativos → ATIVO → o Zoom aplicativo.
Clique em Provisionamento aba.
Em Provisionamento para o aplicativo, clique Editar.
Habilite as Configurações descritas abaixo e, em seguida, clique Salvar.
Criar usuários
Cria ou vincula um usuário no Zoom quando o aplicativo é atribuído a um usuário no Okta.
Atualizar atributos do usuário
Atualiza os atributos de um usuário no Zoom quando o aplicativo é atribuído. Alterações subsequentes no perfil do usuário do Okta não irão Alterar o valor correspondente no Zoom.
Desativar usuários
Desativa a conta Zoom quando o aplicativo não é atribuído no Okta, ou quando a conta Okta é desativada. As contas podem ser reativadas ao Atribuir novamente o aplicativo.
Etapa 5: Atribuir valores a usuários ou grupos
Para atribuir um valor a um usuário individual:
Navegue para Diretório → Pessoas e clique no nome do usuário.
Clique em Perfil aba, então clique Editar.
Preencha o atributo criado na Etapa 2 com o valor que o Zoom espera.
Clique Salvar.
O valor é transmitido prontamente. Confirme o resultado no Portal web do Zoom antes de aplicar a mesma alteração em maior escala.
Para atribuir um valor a um grupo — o padrão mais escalável em que a configuração segue a estrutura organizacional:
Confirme que o atributo foi declarado na Etapa 1 com Tipo de atributo: grupo. Se foi declarado como Pessoal, defina um equivalente ao nível do grupo repetindo a Etapa 1 no usuário do Zoom perfil abaixo do Diretório → Editor de Perfil → Usuários → Todos, selecionando grupo como o tipo de atributo.
Navegue para Diretório → Grupos → o Todos aba, então clique Adicionar grupo.
Insira um Nome e uma Descrição, depois clique em Salvar.
Abra o grupo e clique no Aplicativos aba.
Clique Atribuir aplicativo, depois clique em Atribuir à direita do Zoom aplicativo.
Preencha os atributos de nível do grupo com os valores que devem se aplicar a todos os Membros.
Clique Guardar e voltar, depois clique em Concluído.
Clique no grupo Pessoas aba, então clique Atribuir pessoas.
Pesquise usuários pelo primeiro nome, endereço de e-mail principal ou Nome de usuário e clique no botão Adicionar ao lado de cada um.
Clique Concluído.
Os Membros herdam automaticamente os valores de atributo do grupo. Os usuários adicionados mais tarde herdam-nos ao ingressar, o que torna este padrão duradouro para Integração contínua, em vez de um exercício de migração pontual.
A prioridade do grupo resolve valores conflitantes quando um usuário pertence a vários grupos
Quando um usuário é membro de mais de um grupo que fornece um valor para o mesmo atributo, o Okta transmite o valor do grupo com maior prioridade.
Navegue para Aplicativos → Aplicativos → ATIVO → o Zoom aplicativo.
Clique em Atribuições aba.
Em Filtros, clique Grupos.
Arraste e solte os grupos na ordem pretendida.
Passo 6: Verifique usando o Registo do Sistema da Okta
Navegue para Denunciar → Registo do sistema.
Filtre pelo usuário de destino ou pelo aplicativo Zoom e restrinja o intervalo de tempo à tentativa de provisionamento.
Abra o Evento relevante e revise o detalhe, que inclui o resultado e qualquer erro retornado pelo aplicativo downstream.
Falhas de provisionamento não resolvidas também aparecem no aplicativo Zoom Provisionamento aba. Quando o registro do Okta não for conclusivo, passe para os registros de ligar do Zoom App Marketplace descritos em Verificação do lado do Zoom e erros comuns, que Mostrar a troca bruta de solicitação e resposta.
Comportamento de integração e desligamento no Okta
O escopo é o principal controle de segurança. Usuários não atribuídos ao aplicativo Zoom no Okta nunca são modificados por nenhum mapeamento nesta configuração.
Com Desativar usuários habilitado, desatribuir o aplicativo ou desativar a conta do Okta desativa a conta Zoom automaticamente.
Reatribuir o aplicativo reativa uma conta Zoom previamente desativada, o que torna o pertencimento ao grupo um mecanismo viável para gerenciar quem sai e quem retorna.
Etapa 7: Aplique os cenários de referência no Okta
Os cenários, pré-requisitos e definições de atributos estão na Cenários de referência seção. Aqui é fornecida apenas a configuração do Okta.
Cenário 0 — Departamento. Na Etapa 1, declare o atributo com Nome de Exibir e Nome da variável department, Nome externo department, e Namespace externo urn:ietf:params:scim:schemas:extension:empresarial:2.0:usuário. Use Tipo de atributo: Pessoal. O perfil base do usuário do Okta já contém um department atributo, portanto a Etapa 2 pode ser ignorada — mapeie diretamente a partir dele na Etapa 3, selecionando Criar e atualizar.
Alternativas se department já estiver mapeado. Qualquer um dos itens a seguir se comporta de forma idêntica, fica sob o mesmo pai e não traz pré-condições — substitua o nome do atributo tanto na Nome externo quanto no namespace, e adicione um atributo de origem correspondente na Etapa 2, se o perfil do Okta ainda não contiver um:
centro de custo
campo Corporativa, varia entre usuários, de modo que um valor incorreto fica visível
Organização
Frequentemente idêntico entre todos os usuários, o que torna um erro mais difícil de detectar
employeeNumber
Frequentemente já mapeado como um campo de identidade — verifique antes de declarar
pronomes
Fica sob a Zoom extensão, em vez da empresarial, portanto usa o mesmo namespace que todos os outros cenários deste guia e evita completamente a questão de formato acima
Cenário 1 — unidade do Zoom Phone e extensão automática. Declare zoomPhoneSite com Tipo de atributo: grupo e defina seu valor no grupo do Okta de cada unidade, de modo que o pertencimento ao grupo determine a unidade diretamente e nenhuma lógica de tradução seja necessária. Declare zoomPhoneExtNumber como um atributo pessoal com um valor padrão de 0 a menos que você esteja migrando uma configuração preexistente de extensões.
Cenário 2 — Plano de tarifação de chamadas variável por país. Declare zoomPhoneCallingPlan com Tipo de atributo: grupo e crie um grupo por região do Plano de tarifação de chamadas, definindo o valor do plano em cada atribuição do aplicativo Zoom do grupo. Os usuários herdam o plano correto por meio do pertencimento, e o valor armazenado no Okta é o valor exato que o Zoom espera. Isso também torna a configuração visível e auditável a partir da Atribuições aba, e isso resiste a inconsistências na forma como os dados do diretório subjacente foram preenchidos. Um grupo que contém -1 oferece uma forma limpa de desprovisionar direitos de chamadas sem excluir o usuário.
Cenário 3 — Pacote da central de contato, Função e região. Declare zoomContactCenterPackage como um atributo enumerado restringido aos três valores permitidos, de modo que um Pacote inválido nunca possa ser inserido. Declare zoomContactCenterRole como um atributo no nível do grupo, já que a Função geralmente segue a estrutura da equipe. Sair/sair zoomContactCenterRegion não mapeado em implantações de região única.
Solução de problemas
Erros
Usuário não existe ou não pertence a esta conta
Este erro ocorre quando o endereço de e-mail de um usuário-alvo não consegue ser provisionado devido a uma conta já existente. Os administradores Zoom são incentivados a entrar em contato com o usuário diretamente e Convidar manualmente o usuário para a conta.
Você Não Pode Adicionar Usuários Pagos
Este erro ocorre quando o SCIM tenta provisionar um usuário quando não há licenças suficientes na conta. Para resolver o erro, o usuário deve ser provisionado como um usuário básico ou uma licença deve ser disponibilizada para provisionamento.
Usando os registros SCIM para solucionar problemas de provisionamento de usuários
Zoom fornece os 100 registros mais recentes de solicitações de API em Zoom Marketplace. Um administrador Zoom pode usar esses registros para confirmar quais informações estão sendo enviadas e recebidas por meio das APIs de provisionamento. Para Acessar os registros, entre no Zoom Marketplace como um administrador Zoom e clique em Gerir. Na página seguinte, Selecionar Registros de chamadas em Gerenciamento de aplicativos pessoais. A partir daí, clique em uma entrada para expandir os registros de API e revisar o conteúdo.
A imagem a seguir mostra um exemplo de uma solicitação de provisionamento de usuário SCIM, com a identidade e os atributos de licenciamento do usuário destacados para referência.
Assim como o mapeamento de resposta, o Zoom só pode aplicar as informações enviadas pelo provedor de identidade na solicitação de provisionamento. Use estes registros para confirmar que a identidade do usuário e os atributos de licenciamento estão sendo enviados pelo provedor de identidade. Se as informações esperadas estiverem ausentes dessas declarações, entre em contato com seu provedor de identidade para obter Suporte.
Última atualização
Isto foi útil?