Dodatkowa weryfikacja użytkowników pozwala dodać do poleceń głosowych uwierzytelnianie dwuskładnikowe. Dzięki temu możesz zwiększyć bezpieczeństwo niektórych działań, takich jak wyłączenie kamery monitoringu czy otwarcie drzwi. Dodatkowa weryfikacja użytkownika nie jest powiązana z konkretną cechą urządzenia, która pozwala zdecydować, kiedy Google Assistant ma wykonać test zabezpieczający logowanie. Możesz na przykład ustawić dla kamery monitoringu wyzwanie cech OnOff, ale nie rzucać wyzwania dla OnOff. W określonych sytuacjach możesz też mieć Assistant problemów z wykonaniem tego samego działania. Możesz na przykład poprosić Assistant o wysłanie prośby o weryfikację otwarcia drzwi, jeśli pilot NFC nie znajduje się w pobliżu drzwi. Jeśli w pobliżu jest kluczyk, nie będzie on uruchamiał wyzwania.
Assistant może nakładać 2 rodzaje testów zabezpieczających – potwierdzenie otrzymania zgody lub osobisty numer identyfikacyjny (PIN). Spowoduje to dodanie blokady wyzwania do intencji QUERY i EXECUTE wysłanych przez Assistant z powrotem do działania, co spowoduje otrzymanie odpowiedzi o błędzie challengeNeeded. Assistant następnie wysyła do Twojego działania żądanie intencji z danymi wyzwania w bloku wyzwania. Następnie możesz zweryfikować dane testu zabezpieczającego, aby określić, czy użytkownik udzielił właściwej odpowiedzi.
Assistant używa okna do wystawiania wyzwania, ale jeśli używasz Assistant na platformach innych niż głosowe, PIN i potwierdzenia są przeprowadzane na ekranie.
Obsługiwane typy urządzeń
Dodatkowa weryfikacja użytkownika jest obsługiwana na urządzeniach wszystkich typów.
Obsługiwane traits urządzeń
Dodatkowa weryfikacja użytkownika jest obsługiwana w przypadku wszystkich cech urządzenia.
Obsługiwane rodzaje wyzwań
Obsługiwane są dodatkowe typy testów zabezpieczających weryfikację użytkowników:
- Brak testu zabezpieczającego – żądanie i odpowiedź, które nie zawierają dodatkowej weryfikacji użytkownika.
- ackNeeded – dodatkowa weryfikacja użytkownika, która wymaga jednoznacznego potwierdzenia (tak lub nie) i może też używać stanów cech jako odpowiedzi zwrotnych. Ten typ wyzwania nie jest zalecany w przypadku urządzeń zabezpieczających i cech.
- pinNeeded – dodatkowa weryfikacja użytkownika, która wymaga podania osobistego numeru identyfikacyjnego (PIN), co jest idealnym rozwiązaniem w przypadku urządzeń zabezpieczających i cech charakteru.
Brak wyzwania
Ten przykład pokazuje udane żądanie i odpowiedź EXECUTE, ale bez próby włączenia światła.
| Użytkownik | Włącz światło. |
| Google Assistant | OK, włączam 3 światła. |
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"inputs": [{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [{
"devices": [{
"id": "123"
}],
"execution": [{
"command": "action.devices.commands.OnOff",
"params": {
"on": true
}
}]
}]
}
}]
}
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"payload": {
"commands": [{
"ids": ["123"],
"status": "SUCCESS",
"states": {
"on": true,
"online": true
}
}]
}
}
ackNeeded
Dodatkowe uwierzytelnianie użytkownika, które może wykorzystywać wiele stanów na potrzeby cechy lub proste uwierzytelnianie w ramach potwierdzenia.
Istnieje ackNeeded typów wyzwań, takich jak:
potwierdzone i proste
W tym przykładzie widać proste żądanie i odpowiedź z zadaniem ackNeeded polegającym na przyciemnieniu światła i potwierdzeniem przyciemnienia.
| Użytkownik | Przyciemnij światło w salonie. |
| Google Assistant | Przyciemniam światło w salonie. Na pewno? |
| Użytkownik | Tak. |
| Google Assistant | Przyciemniam światło w salonie. |
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"inputs": [{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [{
"devices": [{
"id": "123"
}],
"execution": [{
"command": "action.devices.commands.BrightnessAbsolute",
"params": {
"brightness": 12
}
}]
}]
}
}]
}
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"payload": {
"commands": [{
"ids": ["123"],
"status": "ERROR",
"errorCode": "challengeNeeded",
"challengeNeeded": {
"type": "ackNeeded"
}
}]
}
}
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"inputs": [{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [{
"devices": [{
"id": "123"
}],
"execution": [{
"command": "action.devices.commands.BrightnessAbsolute",
"params": {
"brightness": 12
},
"challenge": {
"ack": true
}
}]
}]
}
}]
}
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"payload": {
"commands": [{
"ids": ["123"],
"status": "SUCCESS"
}]
}
}
Potrzebowane z uwzględnieniem stanów cech
Dodatkowe uwierzytelnianie użytkownika, które może wykorzystywać stany dla danej cechy.
Jeśli np. pracujesz z cechą TemperatureSetting, a obie opcje są ustawione na thermostatMode i thermostatTemperatureSetpoint,
Assistant może zapytać: Czy na pewno chcesz ustawić ogrzewanie klimatyzatora na 28 stopni?
W odpowiedzi możesz też umieścić stan, by usługa Assistant wykonała określone działanie na podstawie danego żądania.
Poniższe cechy i stany obsługują ackNeeded z różnymi stanami cech. Wskazanie konkretnej cechy wskazuje, że obsługiwane są wszystkie jej stany.
- ArmDisarm
currentArmLevelcurrentStatusReport- Fill
- LockUnlock
- OnOff
on- OpenClose
- Scene
- TemperatureSetting
thermostatModethermostatTemperatureSetpointthermostatTemperatureSetpointHighthermostatTemperatureSetpointLow
Ten przykład przedstawia żądanie i odpowiedź z wyzwaniem ackNeeded używającym stanu cechy. Przełącza tryb klimatyzacji na ogrzewanie i ustawia temperaturę na 28 stopni. Następnie Assistant prosi użytkowników o potwierdzenie, że chcą włączyć ogrzewanie i ustawić temperaturę na 28 stopni, ponieważ stan thermostatTemperatureSetpoint z 28 jest zwracany w odpowiedzi.
| Użytkownik | Ustaw tryb klimatyzacji na ogrzewanie. |
| Google Assistant | Czy na pewno chcesz ustawić ogrzewanie klimatyzatora na 28 stopni? |
| Użytkownik | Tak. |
| Google Assistantnt | Ustawiam ogrzewanie klimatyzatora na 28 stopni. |
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"inputs": [{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [{
"devices": [{
"id": "123"
}],
"execution": [{
"command": "action.devices.commands.TemperatureSetting",
"params": {
"thermostatMode": "heat"
}
}]
}]
}
}]
}
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"payload": {
"commands": [{
"ids": ["123"],
"status": "ERROR",
"states": {
"thermostatMode": "heat",
"thermostatTemperatureSetpoint": 28
},
"errorCode": "challengeNeeded",
"challengeNeeded": {
"type": "ackNeeded"
}
}]
}
}
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"inputs": [{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [{
"devices": [{
"id": "123"
}],
"execution": [{
"command": "action.devices.commands.TemperatureSetting",
"params": {
"thermostatMode": "heat"
},
"challenge": {
"ack": true
}
}]
}]
}
}]
}
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"payload": {
"commands": [{
"ids": ["123"],
"status": "SUCCESS",
"states": {
"thermostatMode": "heat",
"thermostatTemperatureSetpoint": 28
}
}]
}
}
pinNeeded
Test pinNeeded jest zalecany w przypadku urządzeń zabezpieczających.
Ten przykład przedstawia wstępne żądanie i odpowiedź z testem pinNeeded. Ten przykład zwraca odpowiedź zawierającą zadanie pinNeeded, więc Assistant prosi o kod PIN. W tym momencie użytkownik może podać nieprawidłowy lub prawidłowy kod PIN.
Przykładowe żądanie i odpowiedź na nieprawidłowy lub prawidłowy kod PIN:
| Użytkownik | Odblokuj drzwi. |
| Google Assistant | Możesz podać mi kod zabezpieczający? |
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"inputs": [{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [{
"devices": [{
"id": "123"
}],
"execution": [{
"command": "action.devices.commands.LockUnlock",
"params": {
"lock": false
}
}]
}]
}
}]
}
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"payload": {
"commands": [{
"ids": ["123"],
"status": "ERROR",
"errorCode": "challengeNeeded",
"challengeNeeded": {
"type": "pinNeeded"
}
}]
}
}
Błędny kod PIN
Ten przykład przedstawia żądanie i odpowiedź z testem challengeFailedPinNeeded. Tego wyzwania należy użyć, gdy pierwsze wyzwanie pinNeeded się nie powiedzie.
Gdy zostanie zwrócony typ challengeFailedPinNeeded, Assistant ponownie poprosi o podanie kodu zabezpieczającego. Jeśli użytkownik wykona zbyt wiele nieudanych prób, możesz zwrócić odpowiedź o błędzie tooManyFailedAttempts. Patrz Odpowiedzi na błędy.
| Użytkownik | 333222 |
| Google Assistant | Kod jest nieprawidłowy. Możesz podać mi kod zabezpieczający? |
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"inputs": [{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [{
"devices": [{
"id": "123"
}],
"execution": [{
"command": "action.devices.commands.LockUnlock",
"params": {
"lock": false
},
"challenge": {
"pin": "333222"
}
}]
}]
}
}]
}
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"payload": {
"commands": [{
"ids": ["123"],
"status": "ERROR",
"errorCode": "challengeNeeded",
"challengeNeeded": {
"type": "challengeFailedPinNeeded"
}
}]
}
}
Prawidłowy kod PIN
Ten przykład pokazuje żądanie i odpowiedź prawidłowego kodu PIN.
| Użytkownik | 333444 |
| Google Assistant | Otwieram drzwi. |
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"inputs": [{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [{
"devices": [{
"id": "123"
}],
"execution": [{
"command": "action.devices.commands.LockUnlock",
"params": {
"lock": false
},
"challenge": {
"pin": "333444"
}
}]
}]
}
}]
}
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"payload": {
"commands": [{
"ids": ["123"],
"status": "SUCCESS",
"states": {
"isLocked": false,
"isJammed": false
}
}]
}
}
| Użytkownik | Przyciemnij światło w salonie. |
| Google Assistant | Możesz podać mi kod zabezpieczający? |
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"inputs": [{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [{
"devices": [{
"id": "123"
}],
"execution": [{
"command": "action.devices.commands.BrightnessAbsolute",
"params": {
"brightness": 12
}
}]
}]
}
}]
}
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"payload": {
"commands": [{
"ids": ["123"],
"status": "ERROR",
"errorCode": "challengeNeeded",
"challengeNeeded": {
"type": "pinNeeded"
}
}]
}
}
Odpowiedzi z błędami
Oto kilka kodów błędów, które mogą zostać zwrócone w odpowiedziach:
challengeFailedNotSetup– to działanie wymaga kodu zabezpieczającego, który nie został skonfigurowany w aplikacji na urządzeniu.tooManyFailedAttempts– Niestety, zbyt wiele nieudanych prób. Aby to zrobić, otwórz aplikację na urządzeniu.pinIncorrect– Kod zabezpieczający jest nieprawidłowyuserCancelled– OK.
Zobacz pełną listę błędów i wyjątków.