CSP AllJoynManagement

  • Articolo

Il provider di servizi di configurazione AllJoynManagement (CSP) consente a un amministratore IT di enumerare i dispositivi AllJoyn connessi al bus AllJoyn. I dispositivi devono supportare l'interfaccia di configurazione Microsoft AllJoyn (com.microsoft.alljoynmanagement.config). È anche possibile eseguire il push dei file di configurazione negli stessi dispositivi. Per popolare i vari nodi quando si imposta una nuova configurazione, è consigliabile eseguire prima una query per ottenere i valori effettivi per tutti i nodi in tutti i dispositivi collegati. È quindi possibile usare le informazioni della query per impostare i valori del nodo durante il push della nuova configurazione.

Nota

Il provider di servizi di configurazione AllJoynManagement (CSP) è supportato solo in Windows 10 IoT Core (IoT Core).

Questo CSP è stato aggiunto in Windows 10 versione 1511.

Per le impostazioni del firewall, si noti che PublicProfile e PrivateProfile si escludono a vicenda. Il profilo privato deve essere impostato direttamente nel dispositivo stesso e l'unica operazione supportata è Get. Per PublicProfile sono supportati sia Add che Get. Questo provider di servizi di configurazione è progettato per essere usato con AllJoyn Device System Bridge e una comprensione del bridge aiuterà a determinare quando e come usare questo CSP. Per altre informazioni, vedere Device System Bridge (DSB). Per altre informazioni, vedere AllJoyn - Wikipedia.

Nell'esempio seguente viene illustrato il provider del servizio di configurazione AllJoynManagement in formato albero

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

Nell'elenco seguente vengono descritte le caratteristiche e i parametri.

./Vendor/MSFT/AllJoynManagement Nodo radice per il provider del servizio di configurazione AllJoynManagement.

Servizi Elenco di tutti gli oggetti AllJoyn individuati nel bus AllJoyn. Sono inclusi tutti gli oggetti AllJoyn che espongono "com.microsoft.alljoynmanagement.config".

Services/Node name L'ID dispositivo AllJoyn univoco (GUID) che ospita uno o più oggetti configurabili.

Services/Node name/Port Set di porte utilizzato dall'oggetto AllJoyn per comunicare le impostazioni di configurazione. In genere viene usata una sola porta per la comunicazione, ma è possibile specificare più porte.

Services/Node name/Port/Node name Numero di porta usato per la comunicazione. Questo valore viene specificato dall'oggetto AllJoyn configurabile e riportato qui.

Services/Node name/Port/Node name/CfgObject Set di interfacce configurabili disponibili sulla porta dell'oggetto AllJoyn.

Services/Node name/Port/Node name/CfgObject/Node name Il resto di questo URI è un percorso di escape dell'oggetto AllJoyn configurabile ospitato dal ServiceID padre e accessibile dall'oggetto PortNum padre.

Ad esempio, un bridge AllJoyn con l'interfaccia di configurazione AllJoyn specifica di Microsoft "\\FabrikamService\\BridgeConfig" verrebbe specificato nell'URI come: %2FFabrikamService%2FBridgeConfig.

Credenziali Questo è l'archivio credenziali. Un amministratore può impostare le credenziali per ogni dispositivo AllJoyn che richiede l'autenticazione in questo nodo.

Quando una richiesta SyncML arriva nel provider di servizi di configurazione per sostituire o eseguire query su un elemento di configurazione su un oggetto AllJoyn che richiede l'autenticazione, il provider di servizi di configurazione usa le credenziali archiviate qui durante la fase di autenticazione.

Credentials/Node name Questo è lo stesso ID servizio specificato in \AllJoynManagement\Services\ServiceID URI. Viene in genere implementato come GUID.

Credenziali/Nome nodo/Chiave Valore della chiave alfanumerica conforme allo standard di autenticazione AllJoyn SRP KEYX.

Firewall Impostazione del firewall per il servizio AllJoyn.

Firewall/PublicProfile Valore booleano per abilitare o disabilitare il servizio router AllJoyn (AJRouter.dll) per il profilo di rete pubblico.

Firewall/PrivateProfile Valore booleano che indica se il servizio router AllJoyn (AJRouter.dll) è abilitato per il profilo di rete privato.

Esempi

Impostare la configurazione dell'adattatore

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

È necessario sostituire _ALLJOYN_DEVICE_ID_ con un ID dispositivo effettivo. I dati sono rappresentazione con codifica base 64 del file di configurazione che si sta impostando.

Ottenere i dati 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>

Ottenere il 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>

Riferimento del provider di servizi di configurazione