CSP AllJoynManagement

O CSP (provedor de serviços de configuração AllJoynManagement) permite que um administrador de TI enumere os dispositivos AllJoyn conectados ao barramento AllJoyn. Os dispositivos devem dar suporte à interface de configuração do Microsoft AllJoyn (com.microsoft.alljoynmanagement.config). Você também pode enviar arquivos de configuração por push para os mesmos dispositivos. Para preencher os vários nós ao definir uma nova configuração, recomendamos que você faça uma consulta primeiro, para obter os valores reais de todos os nós em todos os dispositivos anexados. Em seguida, você pode usar as informações da consulta para definir os valores do nó ao pressionar a nova configuração.

Observação

O CSP (provedor de serviços de configuração AllJoynManagement) só tem suporte em Windows 10 IoT Core (IoT Core).

Esse CSP foi adicionado no Windows 10, versão 1511.

Para as configurações de firewall, observe que PublicProfile e PrivateProfile são mutuamente exclusivos. O Perfil Privado deve ser definido diretamente no próprio dispositivo e a única operação com suporte é Get. Para PublicProfile, há suporte para Adicionar e Obter. Esse CSP destina-se a ser usado com a Ponte do Sistema de Dispositivo AllJoyn e uma compreensão da ponte ajudará na determinação de quando e como usar esse CSP. Para obter mais informações, confira Ponte do Sistema de Dispositivos (DSB). Para obter mais informações, consulte AllJoyn – Wikipedia.

O exemplo a seguir mostra o provedor de serviços de configuração AllJoynManagement no formato de árvore

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

A lista a seguir descreve as características e parâmetros.

./Vendor/MSFT/AllJoynManagement O nó raiz do provedor de serviços de configuração AllJoynManagement.

Serviços Lista de todos os objetos AllJoyn descobertos no barramento AllJoyn. Todos os objetos AllJoyn que expõem o "com.microsoft.alljoynmanagement.config" estão incluídos.

Nome dos serviços/ A ID exclusiva do dispositivo AllJoyn (um GUID) que hospeda um ou mais objetos configuráveis.

Nome/porta de serviços/ O conjunto de portas que o objeto AllJoyn usa para comunicar as configurações. Normalmente, apenas uma porta é usada para comunicação, mas é possível especificar mais portas.

Nome dos serviços/nó/porta/número da porta do nome do nó usado para comunicação. Esse valor é especificado pelo objeto AllJoyn configurável e refletido aqui.

Nome dos serviços/nó/nome da porta//CfgObject O conjunto de interfaces configuráveis que estão disponíveis na porta do objeto AllJoyn.

Nome dos serviços//Nome da porta//CfgObject/Nome do nó O restante desse URI é um caminho escapado para o objeto AllJoyn configurável hospedado pelo ServiceID pai e acessível pelo PortNum pai.

Por exemplo, uma Ponte AllJoyn com a interface de configuração AllJoyn específica da Microsoft "\\FabrikamService\\BridgeConfig" seria especificada no URI como: %2FFabrikamService%2FBridgeConfig.

Credenciais Este é o repositório de credenciais. Um administrador pode definir credenciais para cada dispositivo AllJoyn que requer autenticação neste nó.

Quando uma solicitação SyncML chega no CSP para substituir ou consultar um item de configuração em um objeto AllJoyn que requer autenticação, o CSP usa as credenciais armazenadas aqui durante a fase de autenticação.

Credenciais/nome do nó Esta é a mesma ID de serviço especificada em \AllJoynManagement\Services\ServiceID URI. Normalmente, ele é implementado como UM GUID.

Credenciais/nome do nó/chave Um valor de chave alfanumérica que está em conformidade com o padrão de autenticação KEYX do AllJoyn SRP.

Firewall Configuração de firewall para o serviço AllJoyn.

Firewall/PublicProfile Valor booliano para habilitar ou desabilitar o serviço de roteador AllJoyn (AJRouter.dll) para o perfil de rede pública.

Firewall/PrivateProfile Valor booliano que indica se o serviço de roteador AllJoyn (AJRouter.dll) está habilitado para o perfil de rede privada.

Exemplos

Definir a configuração do 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>

Você deve substituir _ALLJOYN_DEVICE_ID_ por uma ID real do dispositivo. Os dados são representação codificada base-64 do arquivo de configuração que você está definindo.

Obter dados 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>

Obter o 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>

Referência de provedor de serviços de configuração