Os conectores Miro para fluxos de trabalho Okta permitem que você automatize facilmente tarefas admin repetitivas e de várias etapas no Miro. Aprenda a configurar a automação do fluxo de trabalho e simplificar o gerenciamento de time e usuário .
Relevante para: Plano Enterprise
Conector de gerenciamento de usuários Miro
O Miro User Management Connector permite que clientes empresariais Miro com SCIM habilitado adicionem usuários à sua organização e gerenciem licenças e status de usuários.
Autorize seu Miro User Management Connector:
Ao adicionar um cartão de gerenciamento de usuários do Miro a um fluxo pela primeira vez, você será solicitado a configurar uma conexão para sua organização. Ver Autorização.
Cartões de ação do Miro User Management Connector:
Ação | Descrição |
Criar usuário | Cria um novo usuário. |
Ler usuário | Pesquisar um usuário existente em uma organização por e-mail. |
Atualizar tipo de licença de usuário para completo | Atualiza um recurso de usuário existente, alterando seu Tipo de Licença de Usuário para Completo. |
Atualizar status do usuário | Atualiza um recurso de usuário existente, alterando seu status ativo para um valor verdadeiro ou falso.O conector de gerenciamento de usuários Miro funciona usando seu token SCIM. O Miro User Management está disponível apenas para empresas com SSO e SCIM habilitados. |
Autorização
Você pode criar e gerenciar várias conexões na páginaConexões .
Isso é útil se você plano operar com várias organizações. Cada conexão para o Miro User Management Connector pode apontar para apenas uma Miro Organization.
Para habilitar o SCIM e obter um novo token, ou copiar um token existente, siga as instruções em Como habilitar o SCIM.
Para criar uma nova conexão a partir de um cartão de ação:
- Clique em Nova conexão.
- Insira um apelido de conexão. Recomendamos um nome que represente a organização.
-
Habilite o provisionamento do SCIM na página de integração Enterprise do Miro, seguindo as instruções.
- Copie a URL base do Miro e cole-a no campo URL base na conexão
- Copie o token da API do Miro e cole-o no campo Token de acessoem Conexão
- Clique em Criar. Isso salva sua conexão e o leva de volta ao seu fluxo.
Criar usuário
Cria um usuário dentro da organização.
Entrada
Campo | Definição | Tipo de | (obrigatório) |
Detalhes do usuário | |||
O endereço de e-mail do usuário. | Corda | VERDADEIRO | |
ativo |
O status do usuário.
Quando não especificado, o padrão é false. |
Menu suspenso | FALSO |
Tipo de licença de usuário |
O tipo de licença do usuário.
Quando não especificado, a licença de usuário é definida de acordo com a lógica interna do Miro , que depende do plano da organização. |
Menu suspenso | FALSO |
Cargo (Role): |
O papel do usuário dentro da organização.
Quando não especificado, o padrão é Membro da Organização. |
Menu suspenso | FALSO |
Nome | |||
Nome de família | O sobrenome ou sobrenome do usuário. | Corda | FALSO |
Nome dado | O nome fornecido pelo usuário. | Corda | FALSO |
Nome de exibição | O nome a ser exibido no Miro. | Corda | FALSO |
Saída
Campo | Definição | Tipo de |
Usuário | ||
ID do usuário | O ID do novo usuário. | Corda |
Ler usuário
Pesquisar um usuário existente em uma organização por e-mail
Entrada
Campo | Definição | Tipo de | (obrigatório) |
Consulta | |||
O endereço de e-mail do usuário a ser pesquisado | Corda | VERDADEIRO |
Saída
Campo | Definição | Tipo de |
usuário | ||
ID do usuário | O ID do usuário. | Número |
Tipo de licença de usuário | O tipo de licença do usuário. | Número |
ativo |
O status do usuário.
|
Número |
Nome | ||
Username (Nome de usuário). | O endereço de e-mail do usuário. | Número |
Nome de família | O sobrenome ou sobrenome do usuário. | Número |
Nome dado | O nome fornecido pelo usuário. | Número |
Nome de exibição | O nome exibido no Miro. | Número |
Atualizar tipo de licença de usuário para Completo
Atualiza um recurso de usuário existente, alterando seu tipo de usuário (licença) para Completo.
Entrada
Campo | Definição | Tipo de | (obrigatório) |
usuário | |||
ID do usuário | O ID do usuário. | Corda | VERDADEIRO |
Saída
Campo | Definição | Tipo de |
resposta | ||
Código de status |
status HTTP da solicitação.
Códigos que indicam atualização de licença malsucedida:
|
Número |
Atualizar status do usuário
Atualiza um recurso de usuário existente, alterando seu status ativo para um valor verdadeiro ou falso.
Entrada
Campo | Definição | Tipo de | (obrigatório) |
usuário | |||
ID do usuário | O ID do usuário. | Corda | VERDADEIRO |
ativo |
O novo status do usuário.
|
Menu suspenso | VERDADEIRO |
Saída
Campo | Definição | Tipo de |
resposta | ||
Código de status |
status HTTP da solicitação.
Códigos que indicam atualização de status ativo sem sucesso:
|
Número |
Conector de Administração Miro
O Miro Administration Connector permite que clientes empresariais criem times e gerenciem suas configurações de time e membros das times.
Autorize seu conector de administração Miro:
Ao adicionar um cartão Miro a um fluxo pela primeira vez, você será solicitado a configurar uma conexão para sua organização. Ver Autorização.
Cartões de ação do Conector de Administração Miro :
Ação | Descrição |
Criar time | Cria uma nova time em uma organização existente. |
Pesquisar times | Pesquisar times existentes em uma organização. Os primeiros 10 registros correspondentes são selecionados do Conjunto de Resultados. |
Adicionar membro à Team | Adiciona um novo membro a uma time existente. |
Atualizar função de membro da Team | Atualiza a função de um time em uma time existente. |
Obter configurações da Team | Recupera as configurações de time de uma time existente. |
Atualizar as configurações de políticas de compartilhamento de Team | Atualiza as configurações da política de compartilhamento de uma time existente. |
Atualizar configurações de convite de Team | Atualiza as configurações da política de convites de uma time existente. |
Atualizar configurações de colaboração da Team | Atualiza as configurações da política de colaboração de uma time existente. |
Atualizar as configurações de descoberta da Team | Atualiza as configurações da política de descoberta de uma time existente. |
Atualizar configurações de acesso de cópia de Team | Atualiza as configurações da política de acesso de cópia de uma time existente. |
Eliminação da sessão do usuário (BETA) | Limpa todas as sessões de usuário para um determinado endereço de e-mail. |
Autorização
O Miro Administration Connector funciona usando o OAuth API Token. O Miro Administration Connector está disponível apenas para clientes no plano Enterprises. Para criar uma nova conexão, os usuários devem ter as permissões necessárias para instalar aplicativos com os escopos suportados abaixo.
Você pode criar e gerenciar várias conexões na páginaConexões .
Isso é útil se você plano operar com várias organizações. Cada conexão para o Miro Administration Connector pode apontar para apenas uma Miro Organization.
Para criar uma nova conexão a partir de um cartão de ação:
- Clique em Nova conexão.
- Insira um apelido de conexão. Recomendamos um nome que represente a organização.
- Obtenha o ID da organização e o token de acesso na página de integração Enterprise do Miro, seguindo as instruções.
- Clique em Criar. Isso salva sua conexão e o leva de volta ao seu fluxo.
Escopos suportados:
- organizações: times:escrever
- organizações: times:ler
Criar time
Cria um time em uma organização existente.
Entrada
Campo | Definição | Tipo de | (obrigatório) |
= membros do time | |||
Nome do time | O nome do time. | Corda | VERDADEIRO |
Saída
Campo | Definição | Tipo de |
resposta | ||
ID da Team | O ID da nova time. | Corda |
Pesquisar times
Pesquisar times existentes em uma organização. Os primeiros 10 registros correspondentes são selecionados do Conjunto de Resultados.
Entrada
Campo | Definição | Tipo de | (obrigatório) |
Consulta | |||
Nome do time | Palavras que devem ser combinadas com o nome da time . Qualquer time cujo nome contenha essas palavras exatas será retornada como um conjunto de resultados. As equipes com nomes que correspondem totalmente à consulta estarão no topo do resultado. | Corda | FALSO |
Saída
Campo | Definição | Tipo de |
resposta | ||
Times | Lista com os 10 primeiros times encontrados. Cada time tem os campos abaixo. | Lista |
ID da Team | O ID da time | Corda |
Nome | Nome da time | Corda |
Adicionar membro à time
Adiciona um novo membro a uma time existente.
Entrada
Campo | Definição | Tipo de | (obrigatório) |
= membros do time | |||
ID da Team | O ID da time. | Corda | VERDADEIRO |
Membro | |||
E-mail do usuário | O e-mail do usuário que você deseja adicionar à time. | Corda | VERDADEIRO |
Saída
Campo | Definição | Tipo de |
resposta | ||
ID do membro | O ID do novo membro do time. | Corda |
Atualizar função do membro do time
Atualiza a função de um time em uma time existente.
Entrada
Campo | Definição | Tipo de | (obrigatório) |
= membros do time | |||
ID da Team | O ID da time. | Corda | VERDADEIRO |
Membro | |||
ID do membro | O ID do membro do time. | Corda | VERDADEIRO |
Cargo (Role): |
O novo papel do membro dentro da time.
|
Menu suspenso | VERDADEIRO |
Saída
Campo | Definição | Tipo de |
resposta | ||
ID do membro | O ID do membro do time. | Corda |
Cargo |
A nova função atribuída ao membro do time.
|
Corda |
Obter configurações da Team
Recupera as configurações de time de uma time existente.
Entrada
Campo | Definição | Tipo de | (obrigatório) |
= membros do time | |||
ID da Team | O ID da time. | Corda | VERDADEIRO |
Saída
Campo | Definição | Tipo de |
Configurações de convite do time | ||
Quem pode convidar |
|
Corda |
Convidar usuários externos |
|
Corda |
Configurações de colaboração em Team | ||
Função de coproprietário |
|
Corda |
Configurações de nível de acesso de cópia de Team | ||
Nível de acesso de cópia |
|
Corda |
Limitação do nível de acesso à cópia |
|
Corda |
Configurações de visibilidade do time | ||
Descoberta |
|
Corda |
Configurações da política de compartilhamento de Team | ||
Acesso padrão ao board |
|
Corda |
Acesso à organização padrão |
|
Corda |
Compartilhando na Organização
|
|
Corda |
Compartilhando na Team |
|
Corda |
Compartilhamento por link público |
|
Corda |
Mover board para o time |
|
Corda |
Atualizar as configurações da Política de Compartilhamento de Team
Atualiza as configurações da política de compartilhamento de uma time existente.
Entrada
Campo | Definição | Tipo de | (obrigatório) |
= membros do time | |||
ID da Team | O ID da time. | Corda | VERDADEIRO |
Acesso padrão ao board |
|
Menu suspenso | FALSO |
Acesso à organização padrão |
|
Menu suspenso | FALSO |
Compartilhamento por link público |
|
Menu suspenso | FALSO |
Compartilhando na Team |
|
Menu suspenso | FALSO |
Compartilhando na Organização
|
|
Menu suspenso | FALSO |
Mover board para o time |
|
Menu suspenso | FALSO |
Saída
Campo | Definição | Tipo de |
Configurações da política de compartilhamento de Team | ||
Acesso padrão ao board |
|
Corda |
Acesso à organização padrão |
|
Corda |
Compartilhando na Organização
|
|
Corda |
Compartilhando na Team |
|
Corda |
Compartilhamento por link público |
|
Corda |
Mover board para o time |
|
Corda |
Atualizar configurações de convite de Team
Atualiza as configurações da política de convites de uma time existente.
Entrada
Campo | Definição | Tipo de | (obrigatório) |
= membros do time | |||
ID da Team | O ID da time. | Corda | VERDADEIRO |
Convidar usuários externos |
|
Menu suspenso | FALSO |
Quem pode convidar |
|
Menu suspenso | FALSO |
Saída
Campo | Definição | Tipo de |
Configurações de convite do time | ||
Convidar usuários externos |
|
Corda |
Quem pode convidar |
|
Corda |
Atualizar configurações de acesso à cópia da Team
Atualiza as configurações da política de acesso de cópia de uma time existente.
Entrada
Campo | Definição | Tipo de | (obrigatório) |
= membros do time | |||
ID da Team | O ID da time. | Corda | VERDADEIRO |
Nível de acesso de cópia |
|
Menu suspenso | FALSO |
Limitação do nível de acesso à cópia |
|
Menu suspenso | FALSO |
Saída
Campo | Definição | Tipo de |
Configurações de acesso à cópia da Team | ||
Nível de acesso de cópia |
|
Corda |
Limitação do nível de acesso à cópia |
|
Corda |
Atualizar as configurações de colaboração da Team
Atualiza as configurações da política de colaboração de uma time existente.
Entrada
Campo | Definição | Tipo de | (obrigatório) |
= membros do time | |||
ID da Team | O ID da time. | Corda | VERDADEIRO |
Função de coproprietário |
|
Menu suspenso | FALSO |
Saída
Campo | Definição | Tipo de |
Configurações de colaboração em Team | ||
Função de coproprietário |
|
Corda |
Atualizar as configurações do Team Discovery
Atualiza as configurações da política de descoberta de uma time existente.
Entrada
Campo | Definição | Tipo de | (obrigatório) |
= membros do time | |||
ID da Team | O ID da time. | Corda | VERDADEIRO |
Descoberta |
|
Menu suspenso | FALSO |
Saída
Campo | Definição | Tipo de |
Configurações de visibilidade do time | ||
Descoberta |
|
Corda |
Eliminação da sessão do usuário
Limpa todas as sessões de usuário para um determinado endereço de e-mail.
Entrada
Campo | Definição | Tipo de | (obrigatório) |
Detalhes do usuário | |||
O endereço de e-mail do usuário cujas sessões devem ser apagadas. | Corda | VERDADEIRO |
Saída
Campo | Definição | Tipo de |
resposta | ||
Código de status |
status HTTP da solicitação.
Códigos que indicam atualização malsucedida de eliminação de sessão do usuário :
|
Número |