blob: 2b1ac70012561d8f7436516fca546d295ff475a0 [file] [log] [blame] [edit]
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="identitytoolkit_v2.html">Identity Toolkit API</a> . <a href="identitytoolkit_v2.accounts.html">accounts</a> . <a href="identitytoolkit_v2.accounts.mfaSignIn.html">mfaSignIn</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
<code><a href="#finalize">finalize(body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Verifies the MFA challenge and performs sign-in</p>
<p class="toc_element">
<code><a href="#start">start(body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Sends the MFA challenge</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="close">close()</code>
<pre>Close httplib2 connections.</pre>
</div>
<div class="method">
<code class="details" id="finalize">finalize(body=None, x__xgafv=None)</code>
<pre>Verifies the MFA challenge and performs sign-in
Args:
body: object, The request body.
The object takes the form of:
{ # Finalizes sign-in by verifying MFA challenge.
&quot;mfaEnrollmentId&quot;: &quot;A String&quot;, # The MFA enrollment ID from the user&#x27;s list of current MFA enrollments.
&quot;mfaPendingCredential&quot;: &quot;A String&quot;, # Required. Pending credential from first factor sign-in.
&quot;phoneVerificationInfo&quot;: { # Phone Verification info for a FinalizeMfa request. # Proof of completion of the SMS based MFA challenge.
&quot;androidVerificationProof&quot;: &quot;A String&quot;, # Android only. Uses for &quot;instant&quot; phone number verification though GmsCore.
&quot;code&quot;: &quot;A String&quot;, # User-entered verification code.
&quot;phoneNumber&quot;: &quot;A String&quot;, # Required if Android verification proof is presented.
&quot;sessionInfo&quot;: &quot;A String&quot;, # An opaque string that represents the enrollment session.
},
&quot;tenantId&quot;: &quot;A String&quot;, # The ID of the Identity Platform tenant the user is signing in to. If not set, the user will sign in to the default Identity Platform project.
&quot;totpVerificationInfo&quot;: { # TOTP verification info for FinalizeMfaSignInRequest. # Proof of completion of the TOTP based MFA challenge.
&quot;verificationCode&quot;: &quot;A String&quot;, # User-entered verification code.
},
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # FinalizeMfaSignIn response.
&quot;idToken&quot;: &quot;A String&quot;, # ID token for the authenticated user.
&quot;phoneAuthInfo&quot;: { # Phone Verification info for a FinalizeMfa response. # Extra phone auth info, including android verification proof.
&quot;androidVerificationProof&quot;: &quot;A String&quot;, # Android only. Long-lived replacement for valid code tied to android device.
&quot;androidVerificationProofExpireTime&quot;: &quot;A String&quot;, # Android only. Expiration time of verification proof in seconds.
&quot;phoneNumber&quot;: &quot;A String&quot;, # For Android verification proof.
},
&quot;refreshToken&quot;: &quot;A String&quot;, # Refresh token for the authenticated user.
}</pre>
</div>
<div class="method">
<code class="details" id="start">start(body=None, x__xgafv=None)</code>
<pre>Sends the MFA challenge
Args:
body: object, The request body.
The object takes the form of:
{ # Starts multi-factor sign-in by sending the multi-factor auth challenge.
&quot;mfaEnrollmentId&quot;: &quot;A String&quot;, # Required. MFA enrollment id from the user&#x27;s list of current MFA enrollments.
&quot;mfaPendingCredential&quot;: &quot;A String&quot;, # Required. Pending credential from first factor sign-in.
&quot;phoneSignInInfo&quot;: { # App Verification info for a StartMfa request. # Verification info to authorize sending an SMS for phone verification.
&quot;autoRetrievalInfo&quot;: { # The information required to auto-retrieve an SMS. # Android only. Used by Google Play Services to identify the app for auto-retrieval.
&quot;appSignatureHash&quot;: &quot;A String&quot;, # The Android app&#x27;s signature hash for Google Play Service&#x27;s SMS Retriever API.
},
&quot;captchaResponse&quot;: &quot;A String&quot;, # The reCAPTCHA Enterprise token provided by the reCAPTCHA client-side integration. Required when reCAPTCHA enterprise is enabled.
&quot;clientType&quot;: &quot;A String&quot;, # The client type, web, android or ios. Required when reCAPTCHA Enterprise is enabled.
&quot;iosReceipt&quot;: &quot;A String&quot;, # iOS only. Receipt of successful app token validation with APNS.
&quot;iosSecret&quot;: &quot;A String&quot;, # iOS only. Secret delivered to iOS app via APNS.
&quot;phoneNumber&quot;: &quot;A String&quot;, # Required for enrollment. Phone number to be enrolled as MFA.
&quot;playIntegrityToken&quot;: &quot;A String&quot;, # Android only. Used to assert application identity in place of a recaptcha token (or safety net token). A Play Integrity Token can be generated via the [PlayIntegrity API] (https://developer.android.com/google/play/integrity) with applying SHA256 to the `phone_number` field as the nonce.
&quot;recaptchaToken&quot;: &quot;A String&quot;, # Web only. Recaptcha solution.
&quot;recaptchaVersion&quot;: &quot;A String&quot;, # The reCAPTCHA version of the reCAPTCHA token in the captcha_response. Required when reCAPTCHA Enterprise is enabled.
&quot;safetyNetToken&quot;: &quot;A String&quot;, # Android only. Used to assert application identity in place of a recaptcha token. A SafetyNet Token can be generated via the [SafetyNet Android Attestation API](https://developer.android.com/training/safetynet/attestation.html), with the Base64 encoding of the `phone_number` field as the nonce.
},
&quot;tenantId&quot;: &quot;A String&quot;, # The ID of the Identity Platform tenant the user is signing in to. If not set, the user will sign in to the default Identity Platform project.
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # StartMfaSignIn response.
&quot;phoneResponseInfo&quot;: { # Phone Verification info for a StartMfa response. # MultiFactor sign-in session information specific to SMS-type second factors. Along with the one-time code retrieved from the sent SMS, the contents of this session information should be passed to FinalizeMfaSignIn to complete the sign in.
&quot;sessionInfo&quot;: &quot;A String&quot;, # An opaque string that represents the enrollment session.
},
}</pre>
</div>
</body></html>