Condividi tramite


CSP w7 APPLICATION

La tabella seguente mostra l'applicabilità di Windows:

Edizione Windows 10 Windows 11
Home
Pro
Windows SE No
Lavoro
Per le aziende
Istruzione

Il provider di servizi di configurazione APPLICATION con APPID w7 viene usato per avviare un dispositivo con un account OMA DM. Anche se questo provider di servizi di configurazione viene usato per configurare un account OMA DM, viene gestito tramite il provisioning client OMA.

Nota

Questo provider di servizi di configurazione richiede l'accesso alle funzionalità ID_CAP_CSP_FOUNDATION e ID_CAP_DEVICE_MANAGEMENT_ADMIN da un'applicazione di configurazione di rete.

Di seguito viene illustrato il provider di servizi di configurazione in formato albero usato dal provisioning client OMA.

APPLICATION
---APPADDR
------ADDR
------ADDRTYPE
------PORT
---------PORTNBR
---APPAUTH
------AAUTHDATA
------AAUTHLEVEL
------AAUTHNAME
------AAUTHSECRET
------AAUTHTYPE
---AppID
---BACKCOMPATRETRYDISABLED
---CONNRETRYFREQ
---DEFAULTENCODING
---INIT
---INITIALBACKOFTIME
---MAXBACKOFTIME
---NAME
---PROTOVER
---PROVIDER-ID
---ROLE
---TO-NAPID
---USEHWDEVID
---SSLCLIENTCERTSEARCHCRITERIA

Nota

Tutti i nomi di parametro e i tipi di caratteristiche fanno distinzione tra maiuscole e minuscole e devono usare tutte le lettere maiuscole. Sia le credenziali APPSRV che CLIENT devono essere fornite nel codice XML di provisioning.

APPADDR Questa caratteristica viene usata nella caratteristica w7 APPLICATION per specificare l'indirizzo del server Dm.

APPADDR/ADDR Opzionale. Il parametro ADDR viene usato nella caratteristica APPADDR per ottenere o impostare l'indirizzo del server OMA DM. Questo parametro accetta un valore di stringa.

APPADDR/ADDRTYPE Opzionale. Il parametro ADDRTYPE viene usato nella caratteristica APPADDR per ottenere o impostare il formato del parametro ADDR. Questo parametro accetta un valore di stringa.

In OMA DM XML, se sono presenti più istanze di questo parametro, viene usato il primo valore di parametro valido.

APPADDR/PORT Questa caratteristica viene usata nella caratteristica APPADDR per specificare le informazioni sulla porta.

APPADDR/PORT/PORTNBR Obbligatorio. Il parametro PORTNBR viene usato nella caratteristica PORT per ottenere o impostare il numero della porta a cui connettersi. Questo parametro accetta un valore numerico in formato stringa.

APPAUTH Questa caratteristica viene usata nella caratteristica w7 APPLICATION per specificare le informazioni di autenticazione.

APPAUTH/AAUTHDATA Opzionale. Il parametro AAUTHDATA viene usato nella caratteristica APPAUTH per ottenere o impostare più dati usati nell'autenticazione. Questo parametro viene usato per comunicare il nonce per il tipo di autenticazione del digest. Questo parametro accetta un valore di stringa. Il valore di questo parametro è codificato in base64 sotto forma di una serie di byte. Se AAUTHTYPE è DIGEST, questo valore viene usato come valore nonce nel calcolo dell'hash MD5 e la forma ottale dei dati binari deve essere usata durante il calcolo dell'hash sul lato server e sul lato dispositivo.

APPAUTH/AAUTHLEVEL Obbligatorio. Il parametro AAUTHLEVEL viene usato nella caratteristica APPAUTH per indicare se le credenziali sono per l'autenticazione server o client. Questo parametro accetta un valore di stringa. È possibile impostare questo valore.

Valori validi:

  • APPSRV: specifica che il client si autentica nel server OMA DM a livello di protocollo DM.

  • CLIENT: specifica che il server esegue l'autenticazione al client OMA DM a livello di protocollo DM.

APPAUTH/AAUTHNAME Opzionale. Il parametro AAUTHNAME viene usato nella caratteristica APPAUTH per distinguere i nomi dei client OMA DM. Questo parametro accetta un valore di stringa. È possibile impostare questo valore.

APPAUTH/AAUTHSECRET Obbligatorio. Il parametro AAUTHSECRET viene usato nella caratteristica APPAUTH per ottenere o impostare il segreto di autenticazione usato per autenticare l'utente. Questo parametro accetta un valore di stringa.

APPAUTH/AAUTHTYPE Opzionale. Il parametro AAUTHTYPE della caratteristica APPAUTH viene usato per ottenere o impostare il metodo di autenticazione. Questo parametro accetta un valore di stringa.

Valori validi:

  • BASIC: specifica che il tipo di autenticazione SyncML DM 'syncml:auth-basic'.
  • DIGEST: specifica che il tipo di autenticazione SyncML DM 'syncml:auth-md5'.
  • Quando AAUTHLEVEL è CLIENT, AAUTHTYPE deve essere DIGEST. Quando AAUTHLEVEL è APPSRV, AAUTHTYPE può essere BASIC o DIGEST.

APPID Obbligatorio. Il parametro APPID viene usato nella caratteristica APPLICATION per distinguere i tipi di protocolli e servizi applicazione disponibili. Questo parametro accetta un valore di stringa. È possibile ottenere o impostare questo valore. L'unico valore valido per configurare l'APPID bootstrap del provisioning client OMA è w7.

BACKCOMPATRETRYDISABLED Opzionale. Il parametro BACKCOMPATRETRYDISABLED viene usato nella caratteristica APPLICATION per specificare se riprovare a inviare di nuovo un pacchetto con una versione precedente del protocollo (ad esempio, 1.1) in SyncHdr (senza includere la prima volta).

Nota

Questo parametro non contiene un valore. L'esistenza di questo parametro significa che il nuovo tentativo di compatibilità con le versioni precedenti è disabilitato. Se il parametro è mancante, significa che il nuovo tentativo di compatibilità con le versioni precedenti è abilitato.

CONNRETRYFREQ Opzionale. Il parametro CONNRETRYFREQ viene usato nella caratteristica APPLICATION per specificare il numero di tentativi eseguiti dal client DM in caso di errori di livello Gestione connessioni o WinInet. Questo parametro accetta un valore numerico in formato stringa. Il valore predefinito è "3". È possibile impostare questo parametro.

DEFAULTENCODING Opzionale. Il parametro DEFAULTENCODING viene usato nella caratteristica APPLICATION per specificare se il client dm deve usare WBXML o XML per il pacchetto dm durante la comunicazione con il server. È possibile ottenere o impostare questo parametro.

I valori validi sono:

  • application/vnd.syncml.dm+xml (impostazione predefinita)
  • application/vnd.syncml.dm+wbxml

INIT Opzionale. Il parametro INIT viene usato nella caratteristica APPLICATION per indicare che il server di gestione vuole che il client avvii una sessione di gestione immediatamente dopo l'approvazione delle impostazioni. Se il documento application w7 corrente verrà inserito nella ROM, il parametro INIT non deve essere presente.

Nota

Questo nodo è destinato solo agli operatori di telefonia mobile e ai server MDM che tentano di usarlo. Questo nodo non è supportato nello scenario di registrazione MDM aziendale. Questo parametro impone al dispositivo di tentare di connettersi al server OMA DM. Il tentativo di connessione ha esito negativo se il codice XML viene impostato durante la fase coldinit. Una causa comune di questo errore è che immediatamente dopo il completamento di coldinit la radio non è ancora pronta.

  INITIALBACKOFFTIME Opzionale. Il parametro INITIALBACKOFFTIME viene usato nella caratteristica APPLICATION per specificare il tempo di attesa iniziale in millisecondi quando il client dm riprova per la prima volta. Il tempo di attesa aumenta in modo esponenziale. Questo parametro accetta un valore numerico in formato stringa. Il valore predefinito è "16000". È possibile ottenere o impostare questo parametro.

MAXBACKOFFTIME Opzionale. Il parametro MAXBACKOFFTIME viene usato nella caratteristica APPLICATION per specificare il numero massimo di millisecondi di sospensione dopo l'errore di invio del pacchetto. Questo parametro accetta il valore numerico in formato stringa. Il valore predefinito è "86400000". È possibile impostare questo parametro.

NOME Opzionale. Il parametro NAME viene usato nella caratteristica APPLICATION per specificare un'identità dell'applicazione leggibile dall'utente. Questo parametro viene usato per definire parte del percorso del Registro di sistema per i parametri APPLICATION. È possibile impostare questo parametro.

Il parametro NAME può essere una stringa o null (nessun valore). Se non viene specificato alcun valore, il percorso predefinito del Registro di <sistema sarà senza nome>.

PROTOVER Opzionale. Il parametro PROTOVER viene usato nella caratteristica APPLICATION per specificare la versione del protocollo OMA DM supportata dal server. Non viene utilizzato alcun valore predefinito. La versione del protocollo impostata da questo nodo corrisponderà alla versione del protocollo segnalata dal client dm al server in SyncHdr nel pacchetto 1. Se questo nodo non viene specificato durante l'aggiunta di un account server dm, viene usata la versione più recente del protocollo DM supportata dal client. In Windows Phone questa versione è 1.2. Questo parametro è un parametro personalizzato Microsoft. È possibile impostare questo parametro.

Valori possibili:

  • 1.1
  • 1.2

PROVIDER-ID Opzionale. Il parametro PROVIDER-ID viene usato nella caratteristica APPLICATION per distinguere i server OMA DM. Specifica l'identificatore del server per un server di gestione usato nella sessione di gestione corrente. Questo parametro accetta un valore di stringa. È possibile impostare questo parametro.

RUOLO Opzionale. Il parametro ROLE viene usato nella caratteristica APPLICATION per specificare la camera dell'applicazione di sicurezza con cui deve essere eseguita la sessione dm durante la comunicazione con il server dm. Gli unici ruoli supportati sono 8 (operatore di telefonia mobile) e 32 (enterprise). Se questo parametro non è presente, viene assunto il ruolo dell'operatore di telefonia mobile. Il ruolo dell'organizzazione può essere impostato solo dal client di registrazione enterprise. Il client aziendale non può impostare il ruolo dell'operatore di telefonia mobile. Questo parametro è un parametro personalizzato Microsoft. Questo parametro accetta un valore numerico in formato stringa. È possibile ottenere o impostare questo parametro.

TO-NAPID Opzionale. Il parametro TO-NAPID viene usato nella caratteristica APPLICATION per specificare il punto di accesso di rete che il client userà per connettersi al server OMA DM. Se vengono specificati più parametri TO-NAPID, verrà archiviato solo il primo valore TO-NAPID. Questo parametro accetta un valore di stringa. È possibile impostare questo parametro.

USEHWDEVID Opzionale. Il parametro USEHWDEVID viene usato nella caratteristica APPLICATION per specificare l'uso dell'identificazione hardware del dispositivo. Non ha un valore.

  • Se il parametro non è presente, il comportamento predefinito consiste nell'usare un GUID specifico dell'applicazione usato anziché l'ID dispositivo hardware.
  • Se il parametro è presente, l'ID dispositivo hardware verrà fornito nel nodo ./DevInfo/DevID e nel locURI di origine per il pacchetto dm inviato al server. L'identità IMEI (International Mobile Subscriber Identity) viene restituita per un dispositivo GSM.

SSLCLIENTCERTSEARCHCRITERIA Opzionale. Il parametro SSLCLIENTCERTSEARCHCRITERIA viene usato nella caratteristica APPLICATION per specificare i criteri di ricerca del certificato client. Questo parametro supporta la ricerca per attributo soggetto e archivi certificati. Se vengono forniti altri criteri, viene ignorato.

La stringa è una concatenazione di coppie nome/valore, ogni membro della coppia delimitato dal carattere "&". Il nome e i valori sono delimitati dal carattere "=". Se sono presenti più valori, ogni valore è delimitato dal carattere Unicode "U+F000". Se il nome o il valore contiene caratteri non inclusi nel set UNRESERVED (come specificato in RFC2396), tali caratteri sono preceduti da escape URI in base alla RFC.

I nomi supportati sono Oggetto e Archivi; La ricerca di certificati con caratteri jolly non è supportata.

Archivi specifica quali archivi certificati verranno cercati dal client dm per trovare il certificato client SSL. Il valore dell'archivio valido è My%5CUser. Il nome dell'archivio non fa distinzione tra maiuscole e minuscole.   Oggetto specifica il certificato da cercare. Ad esempio, per specificare che si desidera un certificato con un particolare attributo Subject ("CN=Tester,O=Microsoft"), usare quanto segue:

Nota

%EF%80%80 è il carattere con codifica UTF8 U+F000.

<parm name="SSLCLIENTCERTSEARCHCRITERIA"
   value="Subject=CN%3DTester,O%3DMicrosoft&amp;Stores=My%5CUser" />

Riferimento del provider di servizi di configurazione