AllJoynManagement CSP

El proveedor de servicios de configuración (CSP) AllJoynManagement permite a un administrador de TI enumerar los dispositivos AllJoyn conectados al bus AllJoyn. Los dispositivos deben admitir la interfaz de configuración de Microsoft AllJoyn (com.microsoft.alljoynmanagement.config). También puede insertar archivos de configuración en los mismos dispositivos. Para rellenar los distintos nodos al establecer una nueva configuración, se recomienda realizar primero una consulta para obtener los valores reales de todos los nodos de todos los dispositivos conectados. A continuación, puede usar la información de la consulta para establecer los valores del nodo al insertar la nueva configuración.

Nota

El proveedor de servicios de configuración (CSP) AllJoynManagement solo se admite en Windows 10 IoT Core (IoT Core).

Este CSP se agregó en Windows 10, versión 1511.

Para la configuración del firewall, tenga en cuenta que PublicProfile y PrivateProfile son mutuamente excluyentes. El perfil privado debe establecerse directamente en el propio dispositivo y la única operación admitida es Get. Para PublicProfile, se admiten Add y Get. Este CSP está pensado para usarse con el puente del sistema de dispositivos AllJoyn, y una comprensión del puente le ayudará a determinar cuándo y cómo usar este CSP. Para obtener más información, vea Device System Bridge (DSB). Para obtener más información, vea AllJoyn - Wikipedia.

En el ejemplo siguiente se muestra el proveedor de servicios de configuración AllJoynManagement en formato de árbol.

./Vendor/MSFT
AllJoynManagement
----Configurations
--------ServiceID
------------Port
----------------PortNum
--------------------ConfigurableObjects
------------------------CfgObjectPath
----Credentials
--------ServiceID
------------Key
----Firewall
--------PublicProfile
--------PrivateProfile
----Services
--------ServiceID
------------AppId
------------DeviceId
------------AppName
------------Manufacturer
------------ModelNumber
------------Description
------------SoftwareVersion
------------AJSoftwareVersion
------------HardwareVersion
----Options
--------QueryIdleTime

En la lista siguiente se describen las características y los parámetros.

./Vendor/MSFT/AllJoynManagement Nodo raíz del proveedor de servicios de configuración AllJoynManagement.

Servicios Lista de todos los objetos AllJoyn que se detectan en el bus AllJoyn. Se incluyen todos los objetos AllJoyn que exponen "com.microsoft.alljoynmanagement.config".

Nombre de nodo o serviciosEl identificador de dispositivo AllJoyn único (un GUID) que hospeda uno o varios objetos configurables.

Services/Node name/Port Conjunto de puertos que usa el objeto AllJoyn para comunicar la configuración. Normalmente, solo se usa un puerto para la comunicación, pero es posible especificar más puertos.

Services/Node name/Port/Node name Número de puerto usado para la comunicación. El objeto AllJoyn configurable especifica este valor y se refleja aquí.

Services/Node name/Port/Node name/CfgObject Conjunto de interfaces configurables que están disponibles en el puerto del objeto AllJoyn.

Services/Node name/Port/Node name/CfgObject/Node name El resto de este URI es una ruta de acceso de escape al objeto AllJoyn configurable hospedado por el ServiceID primario y accesible por el portNum primario.

Por ejemplo, un puente AllJoyn con la interfaz de configuración AllJoyn específica de Microsoft "\\FabrikamService\\BridgeConfig" se especificaría en el URI como: %2FFabrikamService%2FBridgeConfig.

Credenciales Este es el almacén de credenciales. Un administrador puede establecer credenciales para cada dispositivo AllJoyn que requiera autenticación en este nodo.

Cuando llega una solicitud SyncML al CSP para reemplazar o consultar un elemento de configuración en un objeto AllJoyn que requiere autenticación, el CSP usa las credenciales almacenadas aquí durante la fase de autenticación.

Credenciales onombre de nodo Este es el mismo identificador de servicio especificado en \AllJoynManagement\Services\ServiceID URI. Normalmente se implementa como GUID.

Credenciales/Nombre del nodo/Clave Valor de clave alfanumérica que se ajusta al estándar de autenticación KEYX de AllJoyn SRP.

Firewall Configuración del firewall para el servicio AllJoyn.

Firewall/PublicProfile Valor booleano para habilitar o deshabilitar el servicio de enrutador AllJoyn (AJRouter.dll) para el perfil de red pública.

Firewall/PrivateProfile Valor booleano que indica si el servicio de enrutador AllJoyn (AJRouter.dll) está habilitado para el perfil de red privada.

Ejemplos

Establecimiento de la configuración del adaptador

<?xml version="1.0" encoding="utf-8"?>
SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Replace>
      <CmdID>2</CmdID>
      <Item>
        <Target>
          <LocURI>./Vendor/MSFT/AllJoynManagement/Services/_ALLJOYN_DEVICE_ID_/Port/27/Configuration/%2FDSBService%2FAdapterConfig</LocURI>
        </Target>
       <Meta>
          <Format xmlns="syncml:metinf">b64</Format>
        </Meta>       <Data>PAA/AHgAbQBsACAAdgBlAHIAcwBpAG8AbgA9ACIAMQAuADAAIgA/AD4ADQAKADwAQgBhAGMATgBlAHQAQwBmAGcAPgANAAoACQA8AEIAQgBNAEQAUwBlAHIAdgBlAHIAPgANAAoACQAJADwASQBQAEEAZABkAHIAZQBzAHMAPgAxADIANwAuADAALgAwAC4AMQA8AC8ASQBQAEEAZABkAHIAZQBzAHMAPgANAAoACQAJADwAUABvAHIAdAA+ADQANwA4ADAAOAA8AC8AUABvAHIAdAA+AA0ACgAJADwALwBCAEIATQBEAFMAZQByAHYAZQByAD4ADQAKADwALwBCAGEAYwBOAGUAdABDAGYAZwA+AA0ACgAAAA==</Data>
       </Item>
    </Replace>
    <Final/>
  </SyncBody>
</SyncML>

Debe reemplazar _ALLJOYN_DEVICE_ID_ por un identificador de dispositivo real. Los datos son una representación codificada en base 64 del archivo de configuración que está estableciendo.

Obtención de datos de PIN

<?xml version="1.0" encoding="utf-8"?>
<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Get>
      <CmdID>2</CmdID>
      <Item>
        <Target>
          <LocURI>./Vendor/MSFT/AllJoynManagement/Credentials?list=StructData</LocURI>
        </Target>
      </Item>
    </Get>
    <Final/>
  </SyncBody>
</SyncML>

Obtención del firewall PrivateProfile

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
              <Get>
                <CmdID>1</CmdID>
                <Item>
                     <Target>
                       <LocURI>./Vendor/MSFT/AllJoynManagement/Firewall/PrivateProfile</LocURI>
                     </Target>
                </Item>
              </Get>
     <Final/>
  </SyncBody>
</SyncML>

Temas relacionados

Referencia de proveedor de servicios de configuración