NFC onboarding-data

NFC-dataformat: Nyttelast

Nyttelasten i NFC-posten indeholder de faktiske data, der vil blive transmitteret mellem NFC-læseren/skriveren og telefonens NFC-tag. Du kan angive onboarding-oplysningerne i NFC-nyttelasten ved at konfigurere nøgle-værdi-par. Nøglen og værdien er adskilt af et kolonsymbol, som vist nedenfor:

Nøgle-værdi-par-syntaks: <Nøgle>:<Værdi>

Eksempel:

 Onboardingmetode: 1 onboardingdetaljer: http://10.79.130.6/2302005811.xml mac: A4114E0641C2   Netværksnavn_1_: test_ssid Wi-Fi_bruger_ID_1_: testbruger Wi-Fi_adgangskode_1_: test12345 Sikkerhedstilstand_1_: Auto Frekvensbånd_1_: 5 GHz Brugerdefineret_CA-regel: http://custom_ca.example.com/custom.ca 

Du kan også konfigurere nøgle-værdi-parrene i JSON-formatet.

Eksempel:

 { "onboardingMethod": 1, "onboardingDetail": "http://10.79.130.6/2302005811.xml", "mac": "A4114E0641C2",     "onboardingConfig": {     "Network_Name_1_": "test_ssid",         "Wi-Fi_User_ID_1_": "testnavn",         "Wi-Fi_Password_1_": "test12345",         "Security_Mode_1_": "Auto",         "Frequency_Band_1_": "5 GHz",         "Custom_CA_Rule": "http://custom_ca.example.com/custom.ca" } }

Objektet "onboardingConfig" findes kun i JSON-format. Den indeholder oplysninger om Wi-Fi-profil og brugerdefineret CA.

Understøttede nøgle-værdi-par til NFC-onboarding

Nøgle (forskel på store og små bogstaver)VærdiBeskrivelse
onboardingmetode1–5Angiver onboardingmetoden:
  • 1—Cloud-URL
  • 2—Cloud CDA foretrukket
  • 3—Cloud-aktiveringskode
  • 4—Forenet CM
  • 5—Ensartet CM med alternativ TFTP

Dette par er obligatorisk.

Eksempel:

onboardingmetode: 1

onboardingDetaljerHTTP-adresse, aktiveringskode eller alternativ TFTP-adresse svarende til onboarding-metodenAngiver detaljerede oplysninger for den tilsvarende onboarding-metode.
  • For onboardingMethod:1 (Cloud URL) er den tilsvarende værdi en HTTP-adresse.

    Eksempel:

     onboardingmetode: 1 onboardingdetaljer: <url_adresse> ...

  • For onboardingMethod:3 (Cloud Activation Code) er den tilsvarende værdi en aktiveringskode.

    Eksempel:

     onboardingmetode: 3 onboardingdetaljer: <aktiveringskode> ...
  • For onboardingMethod: 5 (Unified CM med alternativ TFTP) er den tilsvarende værdi en alternativ TFTP-adresse.

    Eksempel:

     onboardingmetode:5 onboardingdetaljer:<alt_tftp_adresse> ...
macMAC-adresseAngiver telefonens MAC-adresse.

Dette nøgle-værdi-par er obligatorisk, når de overførte NFC-data signeres (signering eller signering + kryptering).

Telefonen accepterer kun NFC-data, når den konfigurerede MAC-adresse stemmer overens med dens egen MAC-adresse.

Eksempel:

mac:<mac_adresse>

Wi-Fi-profil

For yderligere information om parametrene, se Parametre for Wi-Fi-profil.

Netværksnavn_1_

SSIDDefinerer navnet på det SSID, der vises på telefonen.

Eksempel:

Netværksnavn_1_:<ssid>

Wi-Fi_bruger_ID_1_Bruger-ID til netværksprofilenAngiver bruger-ID'et for Wi-Fi-netværket.

Eksempel:

Wi-Fi_Bruger_ID_1_:<bruger_id>

Wi-Fi-adgangskode_1_Adgangskode til bruger-ID'etAngiver adgangskoden til bruger-ID'et for at få adgang til Wi-Fi-netværket.

Eksempel:

Wi-Fi_Password_1_:<adgangskode>

Sikkerhedstilstand 1Auto|EAP-FAST|||PSK||Ingen|EAP-PEAPVælger den godkendelsesmetode, der bruges til at sikre adgang til Wi-Fi-netværket.

Eksempel:

Sikkerhedstilstand 1: Auto

NFC-onboarding understøtter ikke EAP-TLS.
Frekvensbånd 1Auto|2,4 GHz|5 GHzVælger frekvensbåndet på telefonen for at få adgang til Wi-Fi-netværket.

Eksempel:

Frekvensbånd 1: 5 GHz

Brugerdefineret certifikatmyndighed (CA)
Brugerdefineret_CA-regelBrugerdefineret CA-regelfilAngiver placeringen af den brugerdefinerede CA-regelfil.

Dette nøgle-værdi-par gælder kun for onboarding-metoderne: Cloud URL og Cloud CDA Preferred.

Eksempel:

Brugerdefineret_CA-regel:http://<filadresse>

NFC onboarding-metoder

Følgende tabel viser NFC-onboarding-metoderne, strengsyntaksen for metoderne til konfigurationer i NFC-læseren/skriveren og de gældende opkaldsstyringssystemer for metoderne:

Tabel 1. Oversigt over NFC-onboardingmetoder
Onboarding-metodeTilladt sikkerhedsniveau Opkaldsstyringssystem

Cloud-URL (1) – Registrer telefonen til opkaldsstyringssystemet. Den bruger cloud-URL'en til at hente profilreglen.

Eksempel 1:

 onboardingmetode:1 onboardingdetaljer:<profile_url> mac:<mac_address> Network_Name_1_:<ssid> Wi-Fi_User_ID_1_:<user_id> Wi-Fi_Password_1_:<user_password> Security_Mode_1_:Auto Frekvensbånd_1_:5 GHz Brugerdefineret_CA_regel:<file_url>

Signering, kryptering + signering

BroadWorks

Webex Calling

Webex-opkald til BroadWorks

Cloud CDA foretrukket (2) – CDA prioriteres frem for den lokale DHCP-klargøring.

Det anbefales at scanne NFC-tagget, inden telefonen starter op. Ellers kan brugerne gå glip af det konfigurerbare tidsinterval.

Eksempel 2-1:

 onboardingMetode:2 mac:<mac_address> Network_Name_1_:<ssid> Wi-Fi_User_ID_1_:<user_id> Wi-Fi_Password_1_:<user_password> Security_Mode_1_:Auto Frekvensbånd_1_:5 GHz Brugerdefineret_CA_Regel:<file_url>

Eksempel 2-2:

 onboardingmetode: 2 mac:<mac_adresse>

Eksempel 2-1:

Signering, kryptering + signering

BroadWorks

Webex Calling

Webex-opkald til BroadWorks

Unified CM (hvis både CDA og DHCP onboard fejler)

Eksempel 2-2:

Almindelig tekst, signering, kryptering, kryptering + signering

Cloud-aktiveringskode (3) – Aktiveringskode (kun til Webex). Telefonen kan automatisk registreres i opkaldsstyringssystemet ved hjælp af denne kode.

Hvis brugerne bliver bedt om at indtaste en aktiveringskode på telefonen, kan de vælge at scanne NFC-tagget for at udfylde koden.

Eksempel 3-1:

 onboardingmetode:3 onboardingdetaljer:<aktiveringskode> mac:<mac_adresse>Netværksnavn_1_:<ssid> Wi-Fi_bruger_ID_1_:<bruger_id> Wi-Fi_adgangskode_1_:<bruger_adgangskode>Sikkerhedstilstand_1_:Auto Frekvensbånd_1_:5 GHz Brugerdefineret_CA_regel:<file_url>

Eksempel 3-2:

 onboardingmetode: 3 onboardingdetaljer: <aktiveringskode> mac:<mac_adresse>

Eksempel 3-1:

  • Online NFC: Signering, kryptering + signering
  • Offline NFC: Kryptering + Signering

Webex Calling

Webex-opkald til BroadWorks

Eksempel 3-2:

  • Online NFC: Almindelig tekst, signering, kryptering, kryptering + signering
  • Offline NFC: Kryptering, kryptering + signering

Unified CM (4) – Afbryd den igangværende registrering (hvis eksisterende), og registrer telefonen direkte til Unified CM.

Eksempel 4-1:

 onboardingmetode:4 mac:<mac_address> Network_Name_1_:<ssid> Wi-Fi_User_ID_1_:<user_id> Wi-Fi_Password_1_:<user_password> Security_Mode_1_:Auto Frekvensbånd_1_:5 GHz

Eksempel 4-2:

 onboardingmetode: 4 mac:<mac_adresse>

Eksempel 4-1:

Signering, kryptering + signering

Unified CM

Eksempel 4-2:

Almindelig tekst, signering, kryptering, kryptering + signering

Unified CM med alternative TFTP (5) – afbryd den igangværende registrering (hvis den findes), og registrer telefonen direkte for at Unified CM med den alternative TFTP angivne server.

Kan også bruges, når brugerne skal angive en alternativ TFTP server på telefonen.

Eksempel 5:

 onboardingMetode:5 onboardingDetaljer:<alt_tftp_address> mac:<mac_address> Network_Name_1_:<ssid> Wi-Fi_User_ID_1_:<user_id> Wi-Fi_Password_1_:<user_password> Security_Mode_1_:Auto Frequency_Band_1_:5 GHz

Undertegnelsen

Kryptering + signering

Unified CM
For onboardingmetoderne "Cloud CDA Preferred (2)", "Cloud Activation Code (3)" og "Unified CM (4)" er de eneste tilladte sikkerhedsniveauer, når Wi-Fi konfigurationer eller brugerdefineret CA-regel eller begge tilføjes: Signering og signering + kryptering.

Faser af NFC-onboarding

NFC-onboarding kan udføres i følgende faser:

  • NFC offline: Telefonen er stadig i kassen (er ikke tændt og opretter ikke forbindelse til noget netværk).

    I denne situation kan du bruge en mobiltelefon, der kører en brugerdefineret app, til at scanne NFC-tagget for at skrive onboardingoplysninger til telefonen. Når telefonen starter, starter den onboarding-processen automatisk baseret på de skriftlige oplysninger.

    NFC-onboardingoplysningerne kan bestemme, hvilket opkaldskontrolsystem (Unified CM eller Cloud) telefonen skal registreres til, og hvilken indstillingstilstand der er (CDA-foretrukken eller lokal DHCP).

    Under telefonens onboardingproces kan brugerne blive bedt om at vælge en opkaldstjeneste eller indtaste en aktiveringskode eller begge dele.

    Hvis telefonen stadig er pakket i telefonæsken, kan du bruge en NFC-enhed til at scanne det NFC-markerede område NFC-ikon i telefonboksen for at skrive onboardingoplysningerne til telefonen. Telefonen registrerer af sig selv, når den starter op.

  • NFC online: Telefonen (uden NFC-onboardingoplysninger) er tændt og opretter forbindelse til et netværk.

    Du kan scanne NFC-tagget når som helst under onboarding-processen. For at sikre, at NFC-onboardingoplysningerne kan registreres i tide, anbefales det at scanne NFC-tagget, lige efter at telefonen har oprettet forbindelse til et netværk.

    Hvis NFC-onboardingmetoden er Cloud URL (1), Unified CM (4) eller Unified CM med alternativt TFTP (5), afbrydes den igangværende onboardingproces øjeblikkeligt, når du scanner NFC-tagget. Og en ny onboarding-proces starter, telefonen registreres til opkaldsstyringssystemet i henhold til den valgte metode (UCM eller Cloud).

    Under telefonens onboardingproces kan du blive bedt om at indtaste nogle oplysninger (f.eks. TFTP server eller aktiveringskode) for at fortsætte processen. I denne situation kan du vælge at scanne NFC-tagget for automatisk at udfylde oplysningerne på telefonen.