- Inicio
- /
- Integraciones
- /
- Integración de SMS para LDAP...
- /
- Integración de SMS para Entra...
Integración SMS Entra ID mediante archivo CSV
¿Qué es Entra ID, también conocido como Active Directory?
Microsoft Entra ID, anteriormente conocido como Azure Active Directory (Azure AD), es un servicio de gestión de identidades y accesos basado en la nube de Microsoft. Este servicio ayuda a las organizaciones a gestionar y proteger el acceso de los usuarios a las aplicaciones y los datos en una infraestructura de TI híbrida moderna. Mediante el uso de Microsoft Entra ID, las organizaciones pueden ofrecer inicio de sesión único (SSO) y autenticación multifactor para proteger las identidades de los usuarios y mejorar la seguridad. La integración con Microsoft Entra ID y su Directorio Activo (AD) permite sincronizar y gestionar identidades de forma centralizada, simplificando la gestión de usuarios y el control de acceso. Esto es esencial para las organizaciones que desean una gestión de accesos eficaz y segura.
Preste atención a ....
Hay algunas cosas que debes tener en cuenta antes de empezar a crear una integración de SMS AD con SureSMS.
GDPR
Lo primero que debe saber es que SureSMS está accediendo a sus datos personales. Esto significa que ahora estamos empezando a procesar datos para usted y, por lo tanto, debemos, encumplir el GDPR, tienen un acuerdo de tratamiento de datos.
Números de teléfono
Los números de teléfono a los que tenemos que enviar deben estar en tu anuncio. Para poder enviar SMS a una persona, necesitamos conocer su número de teléfono. Por lo tanto, si usted no tiene números de teléfono en su anuncio, o conseguirlo o no hacer una integración.
Borrar contactos
La integración es "unidireccional". Esto significa que sólo leemos la información de AD. La integración toma todas las personas de su AD, por así decirlo. Así, por ejemplo, si eliminas a una persona en SureSMS, sólo volverá si todavía está en AD. Siempre es AD quien tiene los datos correctos.
Cómo configurar la integración de Entra ID
Tenemos varias opciones cuando se trata de la integración de EntraID. Este artículo describe cómo se realiza la integración a través de un archivo CSV.
En general, la solución se basa en un pequeño script que se ejecuta en sus instalaciones (es decir, dentro de los mecanismos de seguridad que haya establecido su organización). El script crea un archivo separado por comas con contenido sobre personas, números de teléfono y grupos, y este archivo se envía de forma segura a través de sFTP a SureSMS. A continuación, SureSMS carga automáticamente el archivo en la cuenta asociada a las integraciones.
Así que, empecemos.
Cómo funciona
Una vez cargado el archivo, se importará automáticamente a los contactos de tu libreta de direcciones en SureSMS.
Formato del archivo CSV
|
Columna
|
Descripción
|
Ejemplo
|
|
Nombre
|
Nombre completo del usuario de Entra ID
|
Anders Jensen
|
|
Código del país
|
Código de marcación con prefijo + |
+45
|
|
Número de teléfono
|
Número de móvil o teléfono del trabajo
|
12345678
|
|
Grupo
|
El nombre del grupo Entra ID al que pertenece el usuario
|
Departamento de informática
|
Requisitos previos
Antes de poder utilizar el script, asegúrese de que su sistema cumple los siguientes requisitos:
- Windows PowerShell 5.1 o posterior (incluido en Windows 10 y 11).
- Módulos PowerShell necesarios: El script intentará instalar automáticamente Gráfico y Posh-SSH, si no están ya instalados. Esto requiere derechos de administrador la primera vez.
- Permisos en Entra ID: El usuario que ejecuta el script debe tener permiso para leer información de usuarios y grupos a través de Microsoft Graph. La primera vez que se ejecute el script, se le pedirá que consienta estos permisos.
- Acceso sFTP a SureSMS: Necesita un nombre de usuario y una contraseña para el servidor sFTP de SureSMS.
Guía paso a paso
Siga estos pasos para configurar y ejecutar el script.
Paso 1: Descargar el script
Primero tienes que descargar El script PowerShell. Guardar el archivo Exportar-EntraIDUsersToSFTP.ps1 en un lugar adecuado de su ordenador, por ejemplo en C:Scripts
Paso 2: Encuentre los detalles de su sFTP en SureSMS
Para que la secuencia de comandos cargue el archivo, necesita sus datos de inicio de sesión sFTP personales de SureSMS. El script ya está configurado para conectarse a sftp.suresms.com, por lo que sólo necesitas tu nombre de usuario y contraseña.
Puedes obtener la información de tu sFTP enviando un correo electrónico a [email protected] con tu número de usuario y la dirección de correo electrónico registrada (consulta la parte inferior izquierda cuando hayas iniciado sesión en app.suresms.com).
Paso 3: Ejecutar el script
Abra una ventana de PowerShell y vaya a la carpeta donde guardó el script. Ahora puede ejecutar el script con los parámetros necesarios.
A continuación se muestra un ejemplo de cómo ejecutar el script. Sustituya los valores por su propia información.
.\Export-EntraIDUsersToSFTP.ps1 -Groups "All Employees", "IT Support" ` -SFTPUsername "ditsftp-username"
Al ejecutar el comando:
- En primer lugar, se le pedirá que inicie sesión en su cuenta de Microsoft para que el script tenga acceso a Entra ID.
- A continuación, se le pedirá que introduzca su contraseña sFTP.
El script recuperará ahora los datos, creará un archivo CSV llamado EntraID_Export.csv y cárguelo en el servidor sFTP de SureSMS.
Parámetros del script
He aquí un resumen de los parámetros que puede utilizar para personalizar la función del script:
| Parámetro | Descripción |
| -Grupos | (Obligatorio) Una lista de los nombres de grupo de Entra ID que desea exportar. Sepárelos con comas, por ejemplo. "Grupo1", "Grupo2". |
| -SFTPUsername | (Obligatorio) Su nombre de usuario sFTP de SureSMS. |
| -Contraseña SFTP | (Opcional) Contraseña como SecureString. Si no se especifica, se le pedirá que la introduzca. |
| -SFTPPort | (Opcional) Puerto sFTP. Por defecto es 22. |
| -SFTPRemotePath | La carpeta en el servidor sFTP donde el archivo debe ser subido. Por defecto es /. |
| -Ruta de salida | (Opcional) Cambia el nombre o la ubicación del archivo CSV local. Por defecto es .\EntraID_Export.csv. |
| -SkipSFTPUpload | (Opcional) Si se especifica, sólo se genera localmente el archivo CSV sin cargarlo en sFTP. |
Ejemplos de uso
Ejemplo 1: Exportar un grupo y cargarlo en SureSMS
.\Export-EntraIDUsersToSFTP.ps1 -Groups "Sales" -SFTPUsername "myuser"
Ejemplo 2: Exportar varios grupos a una carpeta específica
.\Export-EntraIDUsersToSFTP.ps1 -Groups "IT", "HR", "Management" ` -SFTPUsername "myuser" ` -SFTPRemotePath "/contacts"
Ejemplo 3: Sólo exportación local sin carga sFTP
.\Export-EntraIDUsersToSFTP.ps1 -Groups "All Employees" ` -OutputPath "C:\Export\Employees.csv" ` -SkipSFTPUpload
Automatización con el Programador de tareas de Windows
Para mantener sincronizadas sus listas de contactos, puede configurar una tarea programada en Windows que ejecute el script automáticamente a intervalos regulares. Esto garantiza que los nuevos empleados o los cambios en los números de teléfono se reflejen automáticamente en las listas de destinatarios de SureSMS sin ningún trabajo manual.
Para crear una tarea programada:
- Abra el Programador de tareas en Windows.
- Haga clic en Crear tarea básica.
- Asigne un nombre a la tarea, por ejemplo "SureSMS Contact Sync".
- Seleccione la frecuencia con la que debe ejecutarse la tarea (por ejemplo, diariamente).
- Seleccione Iniciar un programa como acción.
- Especifique exe como aplicación y añada la ruta completa del script con parámetros como argumentos.
Ejemplo de argumento:
-ExecutionPolicy Bypass -File "C:\Scripts\Export-EntraIDUsersToSFTP.ps1" -Groups "All Employees" -SFTPUsername "myuser"
Nota: Para la conducción automatizada, debe almacenar la contraseña de forma segura. Puede utilizar -Contraseña SFTP con una SecureString almacenada en un archivo cifrado o ejecute el script bajo una cuenta de servicio con credenciales almacenadas.