Autenticación de solo aplicación de Intune Data Warehouse

Artículo
01/10/2024

Puede configurar una aplicación mediante el identificador de Microsoft Entra y autenticarse en el Data Warehouse de Intune. Este proceso es útil para sitios web, aplicaciones y procesos en segundo plano en los que la aplicación no debe tener acceso a las credenciales de usuario. Con los pasos siguientes, autoriza la aplicación con Microsoft Entra id. mediante OAuth 2.0.

Autorización

Microsoft Entra id. usa OAuth 2.0 para permitir el acceso a aplicaciones web y API web en el inquilino de Microsoft Entra. En esta guía se muestra cómo autenticar la aplicación mediante C#. El flujo de código de autorización de OAuth 2.0 se describe en la sección 4.1 de la especificación de OAuth 2.0. Para obtener más información, consulte Autorización del acceso a aplicaciones web mediante OAuth 2.0 e identificador de Microsoft Entra.

Azure KeyVault

El siguiente proceso usa un método privado para procesar y convertir una clave de aplicación. Este método privado se ha denominado SecureString. Como alternativa, podría usar Azure KeyVault para almacenar la clave de aplicación. Para obtener más información, consulte Key Vault.

Creación de una aplicación web

En esta sección, proporcionará detalles sobre la aplicación web a la que desea que apunte en Intune. Una aplicación web es una aplicación cliente-servidor. El servidor proporciona la aplicación web, que incluye la interfaz de usuario, el contenido y la funcionalidad. Este tipo de aplicación se mantiene por separado en la Web. Use Intune para conceder acceso a una aplicación web a Intune. La aplicación web inicia el flujo de datos.

Inicie sesión en el Centro de administración de Microsoft Intune.
Seleccione Todos los servicios>M365 Microsoft Entra ID>Microsoft Entra ID>Registros de aplicaciones.
Haga clic en Nuevo registro para mostrar el panel Registrar una aplicación .
En el panel Registrar una aplicación , agregue los detalles de la aplicación:
- Un nombre de aplicación, como Intune App-Only Auth.
- Tipo de cuenta compatible.
- Uri de redireccionamiento de la aplicación. Esta es la ubicación a la que los usuarios navegan automáticamente durante el proceso de autenticación. Se les exige que demuestren que son quienes dicen ser. Para obtener más información, consulte ¿Qué es el acceso a la aplicación y el inicio de sesión único con Microsoft Entra id.?
Haga clic en Registrar.

Nota:

Copie el identificador de aplicación (cliente) en el panel de la aplicación para usarlo más adelante.

Crear una clave (contraseña)

En esta sección, Microsoft Entra identificador genera un valor de clave para la aplicación.

En el panel Registros de aplicaciones, seleccione la aplicación recién creada para mostrar el panel de la aplicación.
Seleccione Certificados & secretos cerca de la parte superior del panel para mostrar el panel Certificados & secretos .
Seleccione Secretos de cliente en el panel Certificados & secretos .
Agregue la clave Description y una duración Expires para la clave.
Haga clic en Agregar para guardar y actualizar las claves de la aplicación.
Debe copiar el valor de clave generado (codificado en base64).

Nota:

El valor de clave desaparece después de salir del panel Certificados & secretos . No se puede recuperar la clave de este panel más adelante. Cópielo para usarlo más adelante.

Concesión de permisos de aplicación

En esta sección, concederá permisos a las aplicaciones.

Seleccione Permisos> de APIAgregar un permiso>Permisos de aplicación deIntune>.
Elija la opción get_data_warehouse (Obtener información de almacenamiento de datos de Microsoft Intune).
Haga clic en Agregar permisos.
Haga clic en Listo en el panel Agregar acceso de API .
Haga clic en Conceder consentimiento de administrador en el panel permisos de API y haga clic en Sí cuando se promueva para actualizar los permisos existentes que esta aplicación ya tiene.

Generar token

Con Visual Studio, cree un proyecto de aplicación de consola (.NET Framework) que admita .NET Framework y use C# como lenguaje de codificación.

Seleccione Archivo>nuevo>proyecto para mostrar el cuadro de diálogo Nuevo proyecto .
A la izquierda, seleccione Visual C# para mostrar todos los proyectos de .NET Framework.
Seleccione Aplicación de consola (.NET Framework), agregue un nombre de aplicación y haga clic en Aceptar para crear la aplicación.
En Explorador de soluciones, seleccione Program.cs para mostrar el código.
En Explorador de soluciones, agregue una referencia al ensamblado System.Configuration.
En el menú emergente, seleccione Agregar>nuevo elemento. Se muestra el cuadro de diálogo Agregar nuevo elemento .
A la izquierda, en Visual C#, seleccione Código.
Seleccione Clase, cambie el nombre de la clase a IntuneDataWarehouseClass.cs y haga clic en Agregar.

Agregue el código siguiente dentro del Main método :

     var applicationId = ConfigurationManager.AppSettings["appId"].ToString();
     SecureString applicationSecret = ConvertToSecureStr(ConfigurationManager.AppSettings["appKey"].ToString()); // Load as SecureString from configuration file or secret store (i.e. Azure KeyVault)
     var tenantDomain = ConfigurationManager.AppSettings["tenantDomain"].ToString();
     var msalContext = new AuthenticationContext($"https://login.windows.net/" + tenantDomain + "/oauth2/token");

     AuthenticationResult authResult = msalContext.AcquireTokenAsync(
         resource: "https://api.manage.microsoft.com/",
         clientCredential: new ClientCredential(
             applicationId,
             new SecureClientSecret(applicationSecret))).Result;

Agregue espacios de nombres adicionales agregando el código siguiente en la parte superior del archivo de código:
```
 using System.Security;
 using Microsoft.Identity.Client;
 using System.Configuration;
```
Nota:

Debe usar la Biblioteca de autenticación de Microsoft (MSAL). Para obtener más información, consulte Actualizar las aplicaciones para que usen la Biblioteca de autenticación de Microsoft (MSAL) y la API de Microsoft Graph.

Después del Main método , agregue el siguiente método privado para procesar y convertir la clave de aplicación:

private static SecureString ConvertToSecureStr(string appkey)
{
    if (appkey == null)
        throw new ArgumentNullException("AppKey must not be null.");

    var secureAppKey = new SecureString();

    foreach (char c in appkey)
        secureAppKey.AppendChar(c);

    secureAppKey.MakeReadOnly();
    return secureAppKey;
}

En el Explorador de soluciones, haga clic con el botón derecho en Referencias y, a continuación, seleccione Administrar paquetes NuGet.
Busque Microsoft.Identity.Client e instale el paquete NuGet de Microsoft relacionado.
En Explorador de soluciones seleccione y abra el archivo App.config.

Agregue la appSettings sección para que el xml aparezca de la siguiente manera:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <startup> 
        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6.1" />
    </startup>
    <appSettings>
      <add key="appId" value="App ID created from 'Create a Web App' procedure"/>
      <add key="appKey" value="Key created from 'Create a key' procedure" />
      <add key="tenantDomain" value="contoso.onmicrosoft.com"/>
    </appSettings>
</configuration>

Actualice los appIdvalores , appKeyy tenantDomain para que coincidan con los valores únicos relacionados con la aplicación.
Compile la aplicación.

Nota:

Para ver código de implementación adicional, consulte el ejemplo de código Intune-Data-Warehouse.

Pasos siguientes

Para más información sobre Azure Key Vault, consulte ¿Qué es Azure Key Vault?