Fournisseur de services de configuration AllJoynManagement

  • Article

Le fournisseur de services de configuration (CSP) AllJoynManagement permet à un administrateur informatique d’énumérer les appareils AllJoyn connectés au bus AllJoyn. Les appareils doivent prendre en charge l’interface de configuration De Microsoft AllJoyn (com.microsoft.alljoynmanagement.config). Vous pouvez également envoyer (push) des fichiers de configuration aux mêmes appareils. Pour remplir les différents nœuds lors de la définition d’une nouvelle configuration, nous vous recommandons d’effectuer d’abord une requête afin d’obtenir les valeurs réelles de tous les nœuds de tous les appareils attachés. Vous pouvez ensuite utiliser les informations de la requête pour définir les valeurs de nœud lors de l’envoi (push) de la nouvelle configuration.

Remarque

Le fournisseur de services de configuration (CSP) AllJoynManagement est pris en charge uniquement dans Windows 10 IoT Standard (IoT Core).

Ce fournisseur de services de configuration a été ajouté dans Windows 10, version 1511.

Pour les paramètres de pare-feu, notez que PublicProfile et PrivateProfile s’excluent mutuellement. Le profil privé doit être défini directement sur l’appareil lui-même, et la seule opération prise en charge est Get. Pour PublicProfile, Les options Add et Get sont toutes deux prises en charge. Ce csp est destiné à être utilisé avec le pont système d’appareil AllJoyn, et une compréhension du pont vous aidera à déterminer quand et comment l’utiliser. Pour plus d’informations, consultez DSB (Device System Bridge). Pour plus d’informations, consultez AllJoyn - Wikipédia.

L’exemple suivant montre le fournisseur de services de configuration AllJoynManagement au format d’arborescence

./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

La liste suivante décrit les caractéristiques et les paramètres.

./Vendor/MSFT/AllJoynManagement Nœud racine du fournisseur de services de configuration AllJoynManagement.

Services Liste de tous les objets AllJoyn découverts sur le bus AllJoyn. Tous les objets AllJoyn qui exposent le «com.microsoft.alljoynmanagement.config » sont inclus.

Services/Nom du nœud Id d’appareil AllJoyn unique (GUID) qui héberge un ou plusieurs objets configurables.

Services/Nom du nœud/Port Ensemble de ports que l’objet AllJoyn utilise pour communiquer les paramètres de configuration. En règle générale, un seul port est utilisé pour la communication, mais il est possible de spécifier d’autres ports.

Services/Nom du nœud/Nom du nœud/Nom dunœud Numéro de port utilisé pour la communication. Cette valeur est spécifiée par l’objet AllJoyn configurable et reflétée ici.

Services/Nom du nœud/Port/Nom du nœud/CfgObject Ensemble d’interfaces configurables disponibles sur le port de l’objet AllJoyn.

Services/Nom du nœud/Port/Nom du nœud/CfgObject/Nom du nœud Le reste de cet URI est un chemin d’accès d’échappement à l’objet AllJoyn configurable hébergé par le ServiceID parent et accessible par le PortNum parent.

Par exemple, un pont AllJoyn avec l’interface de configuration AllJoyn spécifique à Microsoft «\\FabrikamService\\BridgeConfig » serait spécifié dans l’URI comme suit : %2FFabrikamService%2FBridgeConfig.

Pouvoirs Il s’agit du magasin d’informations d’identification. Un administrateur peut définir des informations d’identification pour chaque appareil AllJoyn qui nécessite une authentification au niveau de ce nœud.

Lorsqu’une demande SyncML arrive dans le fournisseur de solutions Cloud pour remplacer ou interroger un élément de configuration sur un objet AllJoyn qui nécessite une authentification, le csp utilise les informations d’identification stockées ici pendant la phase d’authentification.

Informations d’identification/Nom du nœud Il s’agit du même ID de service spécifié dans \AllJoynManagement\Services\ServiceID URI. Il est généralement implémenté en tant que GUID.

Informations d’identification/Nom du nœud/Clé Valeur de clé alphanumérique conforme à la norme d’authentification AllJoyn SRP KEYX.

Pare-feu Paramètre de pare-feu pour le service AllJoyn.

Firewall/PublicProfile Valeur booléenne permettant d’activer ou de désactiver le service de routeur AllJoyn (AJRouter.dll) pour le profil de réseau public.

Firewall/PrivateProfile Valeur booléenne indiquant si le service de routeur AllJoyn (AJRouter.dll) est activé pour le profil de réseau privé.

Exemples

Définir la configuration de l’adaptateur

<?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>

Vous devez remplacer _ALLJOYN_DEVICE_ID_ par un ID d’appareil réel. Les données sont une représentation encodée en base 64 du fichier de configuration que vous définissez.

Obtenir des données de code confidentiel

<?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>

Obtenir le pare-feu 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>

Informations de référence sur les fournisseurs de services de configuration