Skip to content

Commit 2f26bcb

Browse files
feat(firebaseappcheck): update the api
#### firebaseappcheck:v1 The following keys were deleted: - resources.projects.resources.apps.methods.exchangeSafetyNetToken (Total Keys: 13) - resources.projects.resources.apps.resources.safetyNetConfig (Total Keys: 44) - schemas.GoogleFirebaseAppcheckV1BatchGetSafetyNetConfigsResponse (Total Keys: 5) - schemas.GoogleFirebaseAppcheckV1ExchangeSafetyNetTokenRequest (Total Keys: 4) - schemas.GoogleFirebaseAppcheckV1SafetyNetConfig (Total Keys: 6) The following keys were added: - schemas.GoogleFirebaseAppcheckV1ExchangeCustomTokenRequest.properties.jti.type (Total Keys: 1) #### firebaseappcheck:v1beta The following keys were deleted: - resources.projects.resources.apps.methods.exchangeSafetyNetToken (Total Keys: 13) - resources.projects.resources.apps.resources.safetyNetConfig (Total Keys: 44) - schemas.GoogleFirebaseAppcheckV1betaBatchGetSafetyNetConfigsResponse (Total Keys: 5) - schemas.GoogleFirebaseAppcheckV1betaExchangeSafetyNetTokenRequest (Total Keys: 4) - schemas.GoogleFirebaseAppcheckV1betaSafetyNetConfig (Total Keys: 6)
1 parent e71009f commit 2f26bcb

12 files changed

Lines changed: 135 additions & 551 deletions

docs/dyn/firebaseappcheck_v1.projects.apps.debugTokens.html

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -114,7 +114,7 @@ <h3>Method Details</h3>
114114
&quot;displayName&quot;: &quot;A String&quot;, # Required. A human readable display name used to identify this debug token.
115115
&quot;etag&quot;: &quot;A String&quot;, # Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. This etag is strongly validated as defined by RFC 7232.
116116
&quot;name&quot;: &quot;A String&quot;, # Required. The relative resource name of the debug token, in the format: ``` projects/{project_number}/apps/{app_id}/debugTokens/{debug_token_id} ```
117-
&quot;token&quot;: &quot;A String&quot;, # Required. Input only. Immutable. The secret token itself. Must be provided during creation, and must be a UUID4, case insensitive. This field is immutable once set, and cannot be provided during an UpdateDebugToken request. You can, however, delete this debug token using DeleteDebugToken to revoke it. For security reasons, this field will never be populated in any response.
117+
&quot;token&quot;: &quot;A String&quot;, # Required. Input only. Immutable. The secret token itself. Must be provided during creation, and must be a UUID4, case insensitive. This field is immutable once set, and cannot be provided during a UpdateDebugToken request. You can, however, delete this debug token using DeleteDebugToken to revoke it. For security reasons, this field will never be populated in any response.
118118
&quot;updateTime&quot;: &quot;A String&quot;, # Output only. Timestamp when this debug token was most recently updated.
119119
}
120120

@@ -130,7 +130,7 @@ <h3>Method Details</h3>
130130
&quot;displayName&quot;: &quot;A String&quot;, # Required. A human readable display name used to identify this debug token.
131131
&quot;etag&quot;: &quot;A String&quot;, # Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. This etag is strongly validated as defined by RFC 7232.
132132
&quot;name&quot;: &quot;A String&quot;, # Required. The relative resource name of the debug token, in the format: ``` projects/{project_number}/apps/{app_id}/debugTokens/{debug_token_id} ```
133-
&quot;token&quot;: &quot;A String&quot;, # Required. Input only. Immutable. The secret token itself. Must be provided during creation, and must be a UUID4, case insensitive. This field is immutable once set, and cannot be provided during an UpdateDebugToken request. You can, however, delete this debug token using DeleteDebugToken to revoke it. For security reasons, this field will never be populated in any response.
133+
&quot;token&quot;: &quot;A String&quot;, # Required. Input only. Immutable. The secret token itself. Must be provided during creation, and must be a UUID4, case insensitive. This field is immutable once set, and cannot be provided during a UpdateDebugToken request. You can, however, delete this debug token using DeleteDebugToken to revoke it. For security reasons, this field will never be populated in any response.
134134
&quot;updateTime&quot;: &quot;A String&quot;, # Output only. Timestamp when this debug token was most recently updated.
135135
}</pre>
136136
</div>
@@ -172,7 +172,7 @@ <h3>Method Details</h3>
172172
&quot;displayName&quot;: &quot;A String&quot;, # Required. A human readable display name used to identify this debug token.
173173
&quot;etag&quot;: &quot;A String&quot;, # Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. This etag is strongly validated as defined by RFC 7232.
174174
&quot;name&quot;: &quot;A String&quot;, # Required. The relative resource name of the debug token, in the format: ``` projects/{project_number}/apps/{app_id}/debugTokens/{debug_token_id} ```
175-
&quot;token&quot;: &quot;A String&quot;, # Required. Input only. Immutable. The secret token itself. Must be provided during creation, and must be a UUID4, case insensitive. This field is immutable once set, and cannot be provided during an UpdateDebugToken request. You can, however, delete this debug token using DeleteDebugToken to revoke it. For security reasons, this field will never be populated in any response.
175+
&quot;token&quot;: &quot;A String&quot;, # Required. Input only. Immutable. The secret token itself. Must be provided during creation, and must be a UUID4, case insensitive. This field is immutable once set, and cannot be provided during a UpdateDebugToken request. You can, however, delete this debug token using DeleteDebugToken to revoke it. For security reasons, this field will never be populated in any response.
176176
&quot;updateTime&quot;: &quot;A String&quot;, # Output only. Timestamp when this debug token was most recently updated.
177177
}</pre>
178178
</div>
@@ -199,7 +199,7 @@ <h3>Method Details</h3>
199199
&quot;displayName&quot;: &quot;A String&quot;, # Required. A human readable display name used to identify this debug token.
200200
&quot;etag&quot;: &quot;A String&quot;, # Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. This etag is strongly validated as defined by RFC 7232.
201201
&quot;name&quot;: &quot;A String&quot;, # Required. The relative resource name of the debug token, in the format: ``` projects/{project_number}/apps/{app_id}/debugTokens/{debug_token_id} ```
202-
&quot;token&quot;: &quot;A String&quot;, # Required. Input only. Immutable. The secret token itself. Must be provided during creation, and must be a UUID4, case insensitive. This field is immutable once set, and cannot be provided during an UpdateDebugToken request. You can, however, delete this debug token using DeleteDebugToken to revoke it. For security reasons, this field will never be populated in any response.
202+
&quot;token&quot;: &quot;A String&quot;, # Required. Input only. Immutable. The secret token itself. Must be provided during creation, and must be a UUID4, case insensitive. This field is immutable once set, and cannot be provided during a UpdateDebugToken request. You can, however, delete this debug token using DeleteDebugToken to revoke it. For security reasons, this field will never be populated in any response.
203203
&quot;updateTime&quot;: &quot;A String&quot;, # Output only. Timestamp when this debug token was most recently updated.
204204
},
205205
],
@@ -234,7 +234,7 @@ <h3>Method Details</h3>
234234
&quot;displayName&quot;: &quot;A String&quot;, # Required. A human readable display name used to identify this debug token.
235235
&quot;etag&quot;: &quot;A String&quot;, # Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. This etag is strongly validated as defined by RFC 7232.
236236
&quot;name&quot;: &quot;A String&quot;, # Required. The relative resource name of the debug token, in the format: ``` projects/{project_number}/apps/{app_id}/debugTokens/{debug_token_id} ```
237-
&quot;token&quot;: &quot;A String&quot;, # Required. Input only. Immutable. The secret token itself. Must be provided during creation, and must be a UUID4, case insensitive. This field is immutable once set, and cannot be provided during an UpdateDebugToken request. You can, however, delete this debug token using DeleteDebugToken to revoke it. For security reasons, this field will never be populated in any response.
237+
&quot;token&quot;: &quot;A String&quot;, # Required. Input only. Immutable. The secret token itself. Must be provided during creation, and must be a UUID4, case insensitive. This field is immutable once set, and cannot be provided during a UpdateDebugToken request. You can, however, delete this debug token using DeleteDebugToken to revoke it. For security reasons, this field will never be populated in any response.
238238
&quot;updateTime&quot;: &quot;A String&quot;, # Output only. Timestamp when this debug token was most recently updated.
239239
}
240240

@@ -251,7 +251,7 @@ <h3>Method Details</h3>
251251
&quot;displayName&quot;: &quot;A String&quot;, # Required. A human readable display name used to identify this debug token.
252252
&quot;etag&quot;: &quot;A String&quot;, # Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. This etag is strongly validated as defined by RFC 7232.
253253
&quot;name&quot;: &quot;A String&quot;, # Required. The relative resource name of the debug token, in the format: ``` projects/{project_number}/apps/{app_id}/debugTokens/{debug_token_id} ```
254-
&quot;token&quot;: &quot;A String&quot;, # Required. Input only. Immutable. The secret token itself. Must be provided during creation, and must be a UUID4, case insensitive. This field is immutable once set, and cannot be provided during an UpdateDebugToken request. You can, however, delete this debug token using DeleteDebugToken to revoke it. For security reasons, this field will never be populated in any response.
254+
&quot;token&quot;: &quot;A String&quot;, # Required. Input only. Immutable. The secret token itself. Must be provided during creation, and must be a UUID4, case insensitive. This field is immutable once set, and cannot be provided during a UpdateDebugToken request. You can, however, delete this debug token using DeleteDebugToken to revoke it. For security reasons, this field will never be populated in any response.
255255
&quot;updateTime&quot;: &quot;A String&quot;, # Output only. Timestamp when this debug token was most recently updated.
256256
}</pre>
257257
</div>

docs/dyn/firebaseappcheck_v1.projects.apps.html

Lines changed: 1 addition & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -104,11 +104,6 @@ <h2>Instance Methods</h2>
104104
</p>
105105
<p class="firstline">Returns the recaptchaV3Config Resource.</p>
106106

107-
<p class="toc_element">
108-
<code><a href="firebaseappcheck_v1.projects.apps.safetyNetConfig.html">safetyNetConfig()</a></code>
109-
</p>
110-
<p class="firstline">Returns the safetyNetConfig Resource.</p>
111-
112107
<p class="toc_element">
113108
<code><a href="#close">close()</a></code></p>
114109
<p class="firstline">Close httplib2 connections.</p>
@@ -136,9 +131,6 @@ <h2>Instance Methods</h2>
136131
<p class="toc_element">
137132
<code><a href="#exchangeRecaptchaV3Token">exchangeRecaptchaV3Token(app, body=None, x__xgafv=None)</a></code></p>
138133
<p class="firstline">Validates a [reCAPTCHA v3 response token](https://developers.google.com/recaptcha/docs/v3). If valid, returns an AppCheckToken.</p>
139-
<p class="toc_element">
140-
<code><a href="#exchangeSafetyNetToken">exchangeSafetyNetToken(app, body=None, x__xgafv=None)</a></code></p>
141-
<p class="firstline">Validates a [SafetyNet token](https://developer.android.com/training/safetynet/attestation#request-attestation-step). If valid, returns an AppCheckToken.</p>
142134
<p class="toc_element">
143135
<code><a href="#generateAppAttestChallenge">generateAppAttestChallenge(app, body=None, x__xgafv=None)</a></code></p>
144136
<p class="firstline">Generates a challenge that protects the integrity of an immediately following call to ExchangeAppAttestAttestation or ExchangeAppAttestAssertion. A challenge should not be reused for multiple calls.</p>
@@ -225,6 +217,7 @@ <h3>Method Details</h3>
225217

226218
{ # Request message for the ExchangeCustomToken method.
227219
&quot;customToken&quot;: &quot;A String&quot;, # Required. A custom token signed using your project&#x27;s Admin SDK service account credentials.
220+
&quot;jti&quot;: &quot;A String&quot;, # Optional. When `limited_use` is set to `true`, this field specifies the desired `jti` claim (Section 4.1.7 of RFC 7519) in the returned App Check token. *Limited use* App Check tokens with the same `jti` will be counted as the same token for the purposes of replay protection. An error is returned if this field is specified without setting `limited_use` to `true`. The size of this field is limited to 500 bytes. If specified, its length must be at least 16 bytes. If this field is omitted or is empty and `limited_use` is set to `true`, a randomly generated `jti` claim with length between 16 and 500 bytes (inclusive) will be used in the returned App Check token. Leaving this field empty is only recommended if your custom attestation provider itself is not vulnerable to replay attacks. When `limited_use` is set to `false`, the presence and the contents of the `jti` claim in the returned App Check token are unspecified. To ensure that the returned App Check token is eligible for limited-use functionality, set `limited_use` to `true`.
228221
&quot;limitedUse&quot;: True or False, # Specifies whether this attestation is for use in a *limited use* (`true`) or *session based* (`false`) context. To enable this attestation to be used with the *replay protection* feature, set this to `true`. The default value is `false`.
229222
}
230223

@@ -382,33 +375,6 @@ <h3>Method Details</h3>
382375
}</pre>
383376
</div>
384377

385-
<div class="method">
386-
<code class="details" id="exchangeSafetyNetToken">exchangeSafetyNetToken(app, body=None, x__xgafv=None)</code>
387-
<pre>Validates a [SafetyNet token](https://developer.android.com/training/safetynet/attestation#request-attestation-step). If valid, returns an AppCheckToken.
388-
389-
Args:
390-
app: string, Required. The relative resource name of the Android app, in the format: ``` projects/{project_number}/apps/{app_id} ``` If necessary, the `project_number` element can be replaced with the project ID of the Firebase project. Learn more about using project identifiers in Google&#x27;s [AIP 2510](https://google.aip.dev/cloud/2510) standard. (required)
391-
body: object, The request body.
392-
The object takes the form of:
393-
394-
{ # Request message for the ExchangeSafetyNetToken method.
395-
&quot;safetyNetToken&quot;: &quot;A String&quot;, # Required. The [SafetyNet attestation response](https://developer.android.com/training/safetynet/attestation#request-attestation-step) issued to your app.
396-
}
397-
398-
x__xgafv: string, V1 error format.
399-
Allowed values
400-
1 - v1 error format
401-
2 - v2 error format
402-
403-
Returns:
404-
An object of the form:
405-
406-
{ # Encapsulates an *App Check token*, which are used to access backend services protected by App Check.
407-
&quot;token&quot;: &quot;A String&quot;, # The App Check token. App Check tokens are signed [JWTs](https://tools.ietf.org/html/rfc7519) containing claims that identify the attested app and GCP project. This token is used to access Google services protected by App Check. These tokens can also be [verified by your own custom backends](https://firebase.google.com/docs/app-check/custom-resource-backend) using the Firebase Admin SDK or third-party libraries.
408-
&quot;ttl&quot;: &quot;A String&quot;, # The duration from the time this token is minted until its expiration. This field is intended to ease client-side token management, since the client may have clock skew, but is still able to accurately measure a duration.
409-
}</pre>
410-
</div>
411-
412378
<div class="method">
413379
<code class="details" id="generateAppAttestChallenge">generateAppAttestChallenge(app, body=None, x__xgafv=None)</code>
414380
<pre>Generates a challenge that protects the integrity of an immediately following call to ExchangeAppAttestAttestation or ExchangeAppAttestAssertion. A challenge should not be reused for multiple calls.

docs/dyn/firebaseappcheck_v1.projects.apps.recaptchaV3Config.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,7 @@ <h2>Instance Methods</h2>
8585
<p class="firstline">Gets the RecaptchaV3Config for the specified app. For security reasons, the `site_secret` field is never populated in the response.</p>
8686
<p class="toc_element">
8787
<code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
88-
<p class="firstline">Updates the RecaptchaV3Config for the specified app. While this configuration is incomplete or invalid, the app will be unable to exchange reCAPTCHA V3 tokens for App Check tokens. For security reasons, the `site_secret` field is never populated in the response.</p>
88+
<p class="firstline">Updates the RecaptchaV3Config for the specified app. While this configuration is incomplete or invalid, the app will be unable to exchange reCAPTCHA v3 tokens for App Check tokens. For security reasons, the `site_secret` field is never populated in the response.</p>
8989
<h3>Method Details</h3>
9090
<div class="method">
9191
<code class="details" id="batchGet">batchGet(parent, names=None, x__xgafv=None)</code>
@@ -145,7 +145,7 @@ <h3>Method Details</h3>
145145

146146
<div class="method">
147147
<code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>
148-
<pre>Updates the RecaptchaV3Config for the specified app. While this configuration is incomplete or invalid, the app will be unable to exchange reCAPTCHA V3 tokens for App Check tokens. For security reasons, the `site_secret` field is never populated in the response.
148+
<pre>Updates the RecaptchaV3Config for the specified app. While this configuration is incomplete or invalid, the app will be unable to exchange reCAPTCHA v3 tokens for App Check tokens. For security reasons, the `site_secret` field is never populated in the response.
149149

150150
Args:
151151
name: string, Required. The relative resource name of the reCAPTCHA v3 configuration object, in the format: ``` projects/{project_number}/apps/{app_id}/recaptchaV3Config ``` (required)

0 commit comments

Comments
 (0)