- Início
- /
- Integrações
- /
- Integração de SMS para LDAP...
- /
- Integração de SMS para o Entra...
Integração SMS Entra ID via ficheiro CSV
O que é o Entra ID, também conhecido como Active Diretory?
O Microsoft Entra ID, anteriormente conhecido como Azure Active Diretory (Azure AD), é um serviço de gestão de identidades e acessos baseado na nuvem da Microsoft. Este serviço ajuda as organizações a gerir e proteger o acesso dos utilizadores a aplicações e dados através de uma infraestrutura de TI híbrida moderna. Ao utilizar o Microsoft Entra ID, as organizações podem oferecer um início de sessão único (SSO) e autenticação multifactor para proteger as identidades dos utilizadores e melhorar a segurança. A integração com o Microsoft Entra ID e o Active Diretory (AD) permite sincronizar e gerir identidades de forma centralizada, simplificando a gestão de utilizadores e o controlo de acesso. Isto é essencial para as organizações que pretendem uma gestão de acesso eficiente e segura.
Prestar atenção a ....
Há alguns aspectos que deve ter em conta antes de começar a criar uma integração SMS AD com a SureSMS.
RGPD
A primeira coisa que precisa de saber é que a SureSMS está a ter acesso aos seus dados pessoais. Isto significa que estamos agora a começar a processar dados para si e, portanto, devemos, emcumprir o RGPD, têm um acordo de processamento de dados.
Números de telefone
Os números de telefone para os quais temos de enviar devem estar no seu AD. Para podermos enviar SMS a uma pessoa, precisamos de saber o seu número de telefone. Por conseguinte, se não tiver números de telefone no seu AD, obtenha-os ou não faça uma integração.
Eliminar contactos
A integração é uma integração "unidirecional". Isto significa que apenas lemos as informações do AD. A integração retira todas as pessoas do seu AD, por assim dizer. Assim, por exemplo, se eliminar uma pessoa na SureSMS, ela só regressará se ainda estiver no AD. É sempre o AD que tem os dados corretos.
Como configurar a sua integração Entra ID
Dispomos de várias opções no que respeita à integração EntraID. Este artigo descreve como é feita a integração através de um ficheiro CSV.
Em geral, a solução baseia-se num pequeno script que é executado nas suas instalações (ou seja, dentro dos mecanismos de segurança que a sua organização estabeleceu). O script cria um ficheiro separado por vírgulas com conteúdo sobre pessoas, números de telefone e grupos, e este ficheiro é enviado de forma segura via sFTP para a SureSMS. A SureSMS carrega então automaticamente o ficheiro na conta associada às integrações.
Então, vamos começar.
Como funciona
Uma vez carregado o ficheiro, este é automaticamente importado para os contactos do seu livro de endereços no SureSMS.
Formato do ficheiro CSV
|
Coluna
|
Descrição
|
Exemplo de um exemplo
|
|
Nome
|
Nome completo do utilizador a partir da Entra ID
|
Anders Jensen
|
|
Código do país
|
Código de marcação com prefixo + |
+45
|
|
Número de telefone
|
Número de telemóvel ou telefone do trabalho
|
12345678
|
|
Grupo
|
O nome do grupo Entra ID a que o utilizador pertence
|
Departamento de TI
|
Pré-requisitos
Antes de poder utilizar o script, certifique-se de que o seu sistema preenche os seguintes requisitos:
- Windows PowerShell 5.1 ou posterior (incluído no Windows 10 e 11).
- Módulos do PowerShell necessários: O script tentará instalar automaticamente Gráfico e Posh-SSH, se ainda não estiverem instalados. Isto requer direitos de administrador na primeira vez.
- Permissões no Entra ID: O utilizador que executa o script deve ter permissão para ler informações de utilizadores e grupos através do Microsoft Graph. Na primeira vez que o script for executado, ser-lhe-á pedido que concorde com estas permissões.
- Acesso sFTP ao SureSMS: É necessário um nome de utilizador e uma palavra-passe para o servidor sFTP do SureSMS.
Guia passo-a-passo
Siga estes passos para configurar e executar o script.
Passo 1: Descarregar o script
Em primeiro lugar, é necessário descarregar O script do PowerShell. Guardar o ficheiro Exportar-EntraIDUsersToSFTP.ps1 numa localização adequada no seu computador, por exemplo, em C:\Scripts
Passo 2: Encontre os seus detalhes sFTP no SureSMS
Para o script carregar o ficheiro, necessita dos seus detalhes pessoais de início de sessão sFTP da SureSMS. O script já está configurado para se ligar a sftp.suresms.com, por isso só precisa do seu nome de utilizador e da sua palavra-passe.
Pode obter as suas informações sFTP enviando uma mensagem de correio eletrónico para [email protected] com o seu número de utilizador e o endereço de correio eletrónico registado (ver o canto inferior esquerdo quando tem sessão iniciada em app.suresms.com)
Passo 3: Executar o script
Abra uma janela do PowerShell e navegue até à pasta onde guardou o script. Pode agora executar o script com os parâmetros necessários.
Abaixo está um exemplo de como executar o script. Substitua os valores pelas suas próprias informações.
.\Export-EntraIDUsersToSFTP.ps1 -Groups "All Employees", "IT Support" ` -SFTPUsername "ditsftp-username"
Quando executa o comando:
- Primeiro, ser-lhe-á pedido que inicie sessão na sua conta Microsoft para dar ao script acesso ao Entra ID.
- Ser-lhe-á então pedido que introduza a sua palavra-passe sFTP.
O script irá agora recuperar os dados, criar um ficheiro CSV com o nome EntraID_Export.csv e carregue-o para o servidor sFTP do SureSMS.
Parâmetros do guião
Eis uma visão geral dos parâmetros que pode utilizar para personalizar a função do guião:
| Parâmetro | Descrição |
| -Grupos | (Obrigatório) Uma lista dos nomes dos grupos do Entra ID que pretende exportar. Separar por vírgulas, por exemplo. "Grupo1", "Grupo2". |
| -SFTPUsername | (Obrigatório) O seu nome de utilizador sFTP da SureSMS. |
| -SFTPPassword | (Opcional) Palavra-passe como SecureString. Se não for especificada, ser-lhe-á pedido que a introduza. |
| -SFTPPort | (Opcional) Porta sFTP. A predefinição é 22. |
| -SFTPRemotePath | A pasta no servidor sFTP onde o ficheiro deve ser carregado. A predefinição é /. |
| -Caminho de saída | (Opcional) Altera o nome ou a localização do ficheiro CSV local. A predefinição é .\EntraID_Export.csv. |
| -SkipSFTPUpload | (Opcional) Se especificado, apenas o ficheiro CSV é gerado localmente sem ser carregado para sFTP. |
Exemplos de utilização
Exemplo 1: Exportar um grupo e carregar para o SureSMS
.\Export-EntraIDUsersToSFTP.ps1 -Groups "Sales" -SFTPUsername "myuser"
Exemplo 2: Exportar vários grupos para uma pasta específica
.\Export-EntraIDUsersToSFTP.ps1 -Groups "IT", "HR", "Management" ` -SFTPUsername "myuser" ` -SFTPRemotePath "/contacts"
Exemplo 3: Exportação local apenas sem carregamento sFTP
.\Export-EntraIDUsersToSFTP.ps1 -Groups "All Employees" ` -OutputPath "C:\Export\Employees.csv" ` -SkipSFTPUpload
Automatização com o Programador de Tarefas do Windows
Para manter as suas listas de contactos sincronizadas, pode configurar uma Tarefa Programada no Windows que executa o script automaticamente em intervalos regulares. Isto garante que os novos empregados ou alterações nos números de telefone são automaticamente reflectidos nas suas listas de destinatários SureSMS sem qualquer trabalho manual.
Para criar uma tarefa agendada:
- Abrir o Programador de Tarefas no Windows.
- Clique em Criar tarefa básica.
- Dê um nome à tarefa, por exemplo, "SureSMS Contact Sync".
- Selecione a frequência com que a tarefa deve ser executada (por exemplo, diariamente).
- Selecionar Iniciar um programa como ação.
- Especificar exe como aplicação e adicionar o caminho completo do script com parâmetros como argumentos.
Exemplo de argumento:
-ExecutionPolicy Bypass -File "C:\Scripts\Export-EntraIDUsersToSFTP.ps1" -Groups "All Employees" -SFTPUsername "myuser"
Nota: Para a condução automatizada, é necessário guardar a palavra-passe de forma segura. Pode utilizar -SFTPPassword com uma SecureString armazenada num ficheiro encriptado ou executar o script numa conta de serviço com credenciais armazenadas.