אימות משתמש משני

אימות משתמש נוסף (SUV) מאפשר להוסיף שכבת אבטחה שנייה לפקודות קוליות. כך אפשר להוסיף שכבת אבטחה לפעולות מסוימות, כמו כיבוי מצלמת אבטחה או פתיחת דלת. אימות משתמש נוסף (SUV) לא קשור למאפיין ספציפי של המכשיר, ולכן אתם יכולים להחליט מתי Google Assistant יציג אתגר. לדוגמה, אפשר לבחור להציג אתגר עבור התכונה OnOff של מצלמת אבטחה, אבל לא להציג אתגר עבור התכונה OnOff של מנורה. אפשר גם להגדיר שיוצגו אתגרים במקרים מסוימים עבור אותה פעולה.Assistant לדוגמה, אפשר לבקש מ-Assistant לשלוח בקשת אתגר לפתיחת דלת אם מחזיק מפתחות NFC לא נמצא בקרבת הדלת, אבל לא לשלוח אתגר אם מחזיק המפתחות נמצא בקרבת הדלת.

Assistant יכול להציג שני סוגים של אתגרים – אישור מפורש או מספר זיהוי אישי (PIN). כך מוסיפים בלוק של אתגר לכוונות QUERY ו-EXECUTE שנשלחות מ-Assistant בחזרה לפעולה שלכם, ומקבלים תגובת שגיאה מסוג challengeNeeded. ‫Assistant שולח בחזרה את בקשת הכוונה לפעולה שלכם עם נתוני האתגר בבלוק האתגר. לאחר מכן תוכלו לאמת את נתוני האתגר כדי לקבוע אם המשתמש סיפק את התשובה הנכונה לשאלת האבטחה.

ב-Assistant נעשה שימוש בתיבת דו-שיח כדי להציג את האתגר, אבל אם משתמשים ב-Assistant בפלטפורמות שאינן קוליות, האימות באמצעות קוד PIN והאישורים מתבצעים במסך.

מתי כדאי להשתמש באימות משתמש נוסף (SUV)

אתם יכולים להפעיל אימות משתמש נוסף (SUV) לכל סוג או מאפיין של מכשיר. עם זאת, כדי שהשילוב יקבל אישור, צריך להטמיע אימות משתמש נוסף (SUV) בסוגים מסוימים של מכשירים ובמאפיינים מסוימים שרגישים לאבטחה.

נדרש אימות משתמש נוסף (SUV) באמצעות סוג האתגר pinNeeded בשילובים הבאים של מאפיינים וסוגי מכשירים:

  • התכונה OnOff אם סוג המכשיר הוא CAMERA.
  • מאפיין OpenClose אם סוג המכשיר הוא DOOR,‏ GARAGE,‏ GATE או WINDOW.
  • מאפיין LockUnlock כשמבטלים את הנעילה.
  • מאפיין ArmDisarm כשמבטלים את ההפעלה או משביתים את המערכת.
  • המאפיין Reboot,‏ SoftwareUpdate או NetworkControl אם סוג המכשיר הוא NETWORK או ROUTER.

אם סוג המכשיר הוא AC_UNIT והשילוב נמצא ביפן, חובה לציין את סוג האתגר ackNeeded למאפיין TemperatureSetting.

סוגי אתגרים נתמכים

אלה סוגי האתגרים הנתמכים של אימות משתמש נוסף (SUV):

  • ללא אתגר – בקשה ותגובה שלא נעשה בהן שימוש באימות משתמש נוסף (SUV).
  • ‫ackNeeded – אימות משתמש נוסף (SUV) שנדרש בו אישור מפורש (כן או לא), ויכול לשמש גם כמשוב על מצבי תכונות. לא מומלץ להשתמש בסוג האתגר הזה במאפיינים ובמכשירים שקשורים לאבטחה.
  • ‫pinNeeded – אימות משתמש נוסף (SUV) שדורש קוד אימות (PIN), שמתאים במיוחד למאפיינים ולמכשירי אבטחה.

אין אתגר

בדוגמה הזו מוצגת בקשה ותגובה מוצלחות של EXECUTE בלי אתגר להדלקת האורות.

משתמש תדליק את האורות.
Google Assistant בסדר, מדליק 3 אורות.
בקשה
{
  "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

אימות משני של אישור משתמש שיכול להשתמש בכמה מצבים למאפיין או באימות פשוט של אישור.

אלה סוגי האתגרים של ackNeeded:

ackNeeded simple

בדוגמה הזו מוצגת בקשה פשוטה ותגובה עם אתגר ackNeeded להנמכת האור ואישור להנמכת האור.

משתמש עמעם את האור בסלון.
Google Assistant הנמכת האור בסלון. להמשיך?
משתמש כן.
Google Assistant עמעום האור בסלון.
בקשה 1
{
  "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
          }
        }]
      }]
    }
  }]
}
תשובה 1
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["123"],
      "status": "ERROR",
      "errorCode": "challengeNeeded",
      "challengeNeeded": {
        "type": "ackNeeded"
      }
    }]
  }
}
בקשה 2
{
  "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
          }
        }]
      }]
    }
  }]
}
תשובה 2
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["123"],
      "status": "SUCCESS"
    }]
  }
}

‫ackNeeded עם מצבי מאפיין

אימות משני של המשתמש שמאפשר להשתמש במצבים עבור תכונה. לדוגמה, אם אתם עובדים עם המאפיין TemperatureSetting והמאפיינים thermostatMode ו-thermostatTemperatureSetpoint מוגדרים, Assistant יכול לשאול האם בטוח שאתם רוצים להגדיר את החימום במזגן ל-28 מעלות?

אפשר גם לכלול מצב בתשובה כדי ש-Assistant יבצע פעולה ספציפית על סמך בקשה נתונה.

התכונות והמצבים הבאים תומכים ב-ackNeeded עם מצבי תכונות. אם מציינים תכונה ספציפית, זה אומר שכל המצבים שלה נתמכים.

  • ArmDisarm
    • משתמשים בסוג האתגר ackNeeded כדי להפעיל או לבטל את הפעלת המכשיר, אבל כדי להשבית או לבטל את השבתת המכשיר, נדרש סוג האתגר pinNeeded.
  • Fill
  • LockUnlock
    • משתמשים בסוג האתגר ackNeeded כדי לנעול את המכשיר ובסוג האתגר pinNeeded כדי לבטל את הנעילה.
  • OnOff
    • on
    • משתמשים בסוג האתגר ackNeeded למאפיין הזה. כשמשתמשים בתכונה הזו במכשירי CAMERA, צריך לציין את סוג האתגר pinNeeded.
  • OpenClose
    • משתמשים בסוג האתגר ackNeeded למאפיין הזה. כשמשתמשים בתכונה הזו עם מכשירי DOOR,‏ GARAGE,‏ GATE או WINDOW, חובה לציין את סוג האתגר pinNeeded.
  • Scene
  • TemperatureSetting
    • thermostatMode
    • thermostatTemperatureSetpoint
    • thermostatTemperatureSetpointHigh
    • thermostatTemperatureSetpointLow

בדוגמה הזו מוצגת בקשה ותגובה עם אתגר ackNeeded שמשתמש במצב מאפיין. היא משנה את מצב המזגן לחימום ומגדירה את הטמפרטורה ל-28 מעלות. לאחר מכן, Assistant מבקש מהמשתמשים לאשר את הפעלת החימום והגדרת הטמפרטורה ל-28 מעלות, כי thermostatTemperatureSetpoint של 28 מוחזר כתגובה.

משתמש הגדר את מצב המיזוג לחימום.
Google Assistant בטוח שברצונך להגדיר את החימום במזגן ל-28 מעלות?
משתמש כן.
Google Assistant הגדרת החימום במזגן ל-28 מעלות.
בקשה 1
{
  "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"
          }
        }]
      }]
    }
  }]
}
תשובה 1
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["123"],
      "status": "ERROR",
      "states": {
        "thermostatMode": "heat",
        "thermostatTemperatureSetpoint": 28
      },
      "errorCode": "challengeNeeded",
      "challengeNeeded": {
        "type": "ackNeeded"
      }
    }]
  }
}
בקשה 2
{
  "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
          }
        }]
      }]
    }
  }]
}
תשובה 2
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["123"],
      "status": "SUCCESS",
      "states": {
        "thermostatMode": "heat",
        "thermostatTemperatureSetpoint": 28
      }
    }]
  }
}

pinNeeded

מומלץ להשתמש באתגר pinNeeded במכשירי אבטחה.

בדוגמה הזו מוצגת בקשה ראשונית ותגובה עם אתגר pinNeeded. בדוגמה הזו מוחזרת תגובה עם אתגר pinNeeded, ולכן Assistant מבקש את קוד האימות. בשלב הזה, המשתמש יכול לספק קוד אימות שגוי או תקין.

דוגמה לבקשה ולתשובה לקוד אימות שגוי או תקין:

משתמש פתיחת הנעילה של הדלת.
Google Assistant אפשר לקבל את קוד האבטחה שלך?
בקשה
{
  "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"
      }
    }]
  }
}

PIN שגוי

בדוגמה הזו מוצגות הבקשה והתגובה עם אתגר challengeFailedPinNeeded. צריך להשתמש באתגר הזה אחרי שאpinNeededתגר ראשוני נכשל.

אם מוחזר סוג challengeFailedPinNeeded, המערכת של Assistant מבקשת שוב את קוד האבטחה. אם המשתמש מבצע יותר מדי ניסיונות כושלים, אפשר להחזיר תגובת שגיאה tooManyFailedAttempts. תגובות שגיאה

משתמש 333222
Google Assistant מצטערים, קוד האבטחה שגוי. אפשר לקבל את קוד האבטחה שלך?
בקשה
{
  "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"
      }
    }]
  }
}

קוד אימות תקין

בדוגמה הזו מוצגות הבקשה והתשובה של קוד אימות תקין.

משתמש 333444
Google Assistant ביטול הנעילה של הדלת.
בקשה
{
  "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
      }
    }]
  }
}
משתמש עמעם את האור בסלון.
Google Assistant אפשר לקבל את קוד האבטחה שלך?
בקשה
{
  "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"
      }
    }]
  }
}

תגובות שגיאה

אלה כמה קודי שגיאה שיכולים לחזור עם התגובות שלכם:

  • ‫tooManyFailedAttempts – מצטערים, היו יותר מדי ניסיונות כושלים. כדי להשלים את הפעולה הזו, צריך לעבור לאפליקציה במכשיר.
  • ‫pinIncorrect – מצטערים, קוד האבטחה שגוי.
  • ‫userCancelled – אישור

רשימה מלאה של שגיאות וחריגים