AllJoynManagement CSP

  • 發行項

AllJoynManagement 設定服務提供者 (CSP) 可讓 IT 系統管理員列舉連線到 AllJoyn 總線的 AllJoyn 裝置。 裝置必須支援 Microsoft AllJoyn 設定介面 (com.microsoft.alljoynmanagement.config) 。 您也可以將組態檔推送至相同的裝置。 若要在設定新設定時填入各種節點，建議您先執行查詢，以取得所有連結裝置中所有節點的實際值。 然後，您可以使用查詢中的資訊來設定推送新組態時的節點值。

注意

只有 Windows 10 IoT 核心版 (IoT 核心版) 才支援 AllJoynManagement 設定服務提供者 (CSP) 。

此 CSP 已在 Windows 10 1511 版中新增。

針對防火牆設定，請注意 PublicProfile 和 PrivateProfile 是互斥的。 私人配置文件必須直接在裝置本身設定，唯一支援的作業是 Get。 針對 PublicProfile，支援 Add 和 Get。 此雲端解決方案提供者旨在與 AllJoyn 裝置系統網橋搭配使用，而瞭解網橋有助於判斷何時及如何使用此 CSP。 如需詳細資訊，請 參閱裝置系統網橋 (DSB) 。 如需詳細資訊，請 參閱 AllJoyn - Wikipedia。

下列範例顯示樹狀結構格式的 AllJoynManagement 設定服務提供者

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

下列清單描述特性和參數。

./Vendor/MSFT/AllJoynManagement AllJoynManagement 設定服務提供者的根節點。

服務 在 AllJoyn 總線上探索到的所有 AllJoyn 物件清單。 所有公開 “com.microsoft.alljoynmanagement.config” 的 AllJoyn 物件都會包含在內。

服務/節點名稱 唯一的 AllJoyn 裝置識別碼 (裝載一或多個可設定物件的 GUID) 。

服務/節點名稱/埠 AllJoyn 物件用來傳達組態設定的埠集合。 通訊通常只會使用一個埠，但可以指定更多埠。

用於通訊的服務/節點名稱/埠/節點名稱 埠號碼。 這個值是由可設定的 AllJoyn 物件指定，並反映在這裡。

Services/Node name/Port/Node name/CfgObject AllJoyn 物件埠上可用的可設定介面集合。

Services/Node name/Port/Node name/CfgObject/Node name 此 URI 的其餘部分是父 ServiceID 所裝載且父端 PortNum 可存取之可設定 AllJoyn 物件的逸出路徑。

例如，在 URI 中會將具有 Microsoft 特定 AllJoyn 組態介面 “\\FabrikamService\\BridgeConfig” 的 AllJoyn Bridge 指定為： %2FFabrikamService%2FBridgeConfig。

憑據 這是認證存放區。 系統管理員可以為此節點上需要驗證的每個 AllJoyn 裝置設定認證。

當 SyncML 要求抵達 CSP，以取代或查詢需要驗證之 AllJoyn 物件上的組態專案時，CSP 會在驗證階段使用此處儲存的認證。

認證/節點名稱 這是 \AllJoynManagement\Services\ServiceID URI 中指定的相同服務標識符。 通常會實作為 GUID。

認證/節點名稱/金鑰 符合 AllJoyn SRP KEYX 驗證標準的英數位元密鑰值。

防火牆 AllJoyn 服務的防火牆設定。

防火牆/PublicProfile 啟用或停用公用網路配置檔之 AllJoyn 路由器服務 (AJRouter.dll) 的布爾值。

Firewall/PrivateProfile 布爾值，指出是否已針對專用網配置檔啟用 AllJoyn 路由器服務 (AJRouter.dll) 。

範例

設定配接器組態

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

您應該將_ALLJOYN_DEVICE_ID_取代為實際的裝置識別碼。 數據是您所設定組態檔的base-64編碼表示法。

取得 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>

取得防火牆 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>

設定服務提供者參考