AllJoynManagement CSP

  • [アーティクル]

AllJoynManagement 構成サービス プロバイダー (CSP) を使用すると、IT 管理者は AllJoyn バスに接続されている AllJoyn デバイスを列挙できます。 デバイスは、Microsoft AllJoyn 構成インターフェイス (com.microsoft.alljoynmanagement.config) をサポートする必要があります。 構成ファイルを同じデバイスにプッシュすることもできます。 新しい構成を設定するときにさまざまなノードを設定するには、まずクエリを実行して、接続されているすべてのデバイスのすべてのノードの実際の値を取得することをお勧めします。 その後、クエリの情報を使用して、新しい構成をプッシュするときにノード値を設定できます。

注

AllJoynManagement 構成サービス プロバイダー (CSP) は、Windows 10 IoT Core (IoT Core) でのみサポートされます。

この CSP は、バージョン 1511 Windows 10で追加されました。

ファイアウォール設定の場合、PublicProfile と PrivateProfile は相互に排他的であることに注意してください。 プライベート プロファイルはデバイス自体で直接設定する必要があり、サポートされている操作は Get のみです。 PublicProfile の場合、Add と Get の両方がサポートされます。 この CSP は 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 オブジェクトが含まれます。

サービス/ノード名 1 つ以上の構成可能なオブジェクトをホストする一意の AllJoyn デバイス ID (GUID)。

サービス/ノード名/ポート AllJoyn オブジェクトが構成設定の通信に使用するポートのセット。 通常、通信に使用されるポートは 1 つだけですが、より多くのポートを指定できます。

サービス/ノード名/ポート/ノード名 通信に使用されるポート番号。 この値は、構成可能な AllJoyn オブジェクトで指定され、ここに反映されます。

Services/Node name/Port/Node name/CfgObject AllJoyn オブジェクトのポートで使用できる構成可能なインターフェイスのセット。

Services/Node name/Port/Node name/CfgObject/Node name この URI の残りの部分は、親 ServiceID によってホストされ、親 PortNum によってアクセスできる構成可能な AllJoyn オブジェクトへのエスケープされたパスです。

たとえば、Microsoft 固有の AllJoyn 構成インターフェイス "\\FabrikamService\\BridgeConfig" を持つ AllJoyn Bridge は、URI で として %2FFabrikamService%2FBridgeConfig指定されます。

資格 情報 これは資格情報ストアです。 管理者は、このノードで認証を必要とする AllJoyn デバイスごとに資格情報を設定できます。

SyncML 要求が CSP に届き、認証を必要とする AllJoyn オブジェクトの構成項目を置き換えたりクエリを実行したりすると、CSP は認証フェーズ中にここに格納されている資格情報を使用します。

Credentials/Node name これは、\AllJoynManagement\Services\ServiceID URI で指定されたのと同じサービス ID です。 通常、GUID として実装されます。

Credentials/Node name/Key AllJoyn SRP KEYX 認証標準に準拠する英数字キー値。

ファイアウォール AllJoyn サービスのファイアウォール設定。

Firewall/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_を実際のデバイス 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>

構成サービス プロバイダーのリファレンス