Skip to content

Commit 13220f0

Browse files
feat(firebaseappcheck): update the api
#### firebaseappcheck:v1beta The following keys were added: - resources.projects.resources.apps.methods.exchangeRecaptchaEnterpriseToken (Total Keys: 12) - resources.projects.resources.apps.resources.recaptchaEnterpriseConfig.methods.batchGet (Total Keys: 14) - resources.projects.resources.apps.resources.recaptchaEnterpriseConfig.methods.get (Total Keys: 11) - resources.projects.resources.apps.resources.recaptchaEnterpriseConfig.methods.patch (Total Keys: 15) - schemas.GoogleFirebaseAppcheckV1betaBatchGetRecaptchaEnterpriseConfigsResponse (Total Keys: 4) - schemas.GoogleFirebaseAppcheckV1betaExchangeRecaptchaEnterpriseTokenRequest (Total Keys: 3) - schemas.GoogleFirebaseAppcheckV1betaRecaptchaEnterpriseConfig (Total Keys: 6)
1 parent eb3572f commit 13220f0

File tree

3 files changed

+380
-1
lines changed

3 files changed

+380
-1
lines changed

docs/dyn/firebaseappcheck_v1beta.projects.apps.html

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,11 @@ <h2>Instance Methods</h2>
9494
</p>
9595
<p class="firstline">Returns the recaptchaConfig Resource.</p>
9696

97+
<p class="toc_element">
98+
<code><a href="firebaseappcheck_v1beta.projects.apps.recaptchaEnterpriseConfig.html">recaptchaEnterpriseConfig()</a></code>
99+
</p>
100+
<p class="firstline">Returns the recaptchaEnterpriseConfig Resource.</p>
101+
97102
<p class="toc_element">
98103
<code><a href="firebaseappcheck_v1beta.projects.apps.safetyNetConfig.html">safetyNetConfig()</a></code>
99104
</p>
@@ -117,6 +122,9 @@ <h2>Instance Methods</h2>
117122
<p class="toc_element">
118123
<code><a href="#exchangeDeviceCheckToken">exchangeDeviceCheckToken(app, body=None, x__xgafv=None)</a></code></p>
119124
<p class="firstline">Accepts a [`device_token`](https://developer.apple.com/documentation/devicecheck/dcdevice) issued by DeviceCheck, and attempts to validate it with Apple. If valid, returns an App Check token encapsulated in an AttestationTokenResponse.</p>
125+
<p class="toc_element">
126+
<code><a href="#exchangeRecaptchaEnterpriseToken">exchangeRecaptchaEnterpriseToken(app, body=None, x__xgafv=None)</a></code></p>
127+
<p class="firstline">Validates a [reCAPTCHA Enterprise response token](https://cloud.google.com/recaptcha-enterprise/docs/create-assessment#retrieve_token). If valid, returns an App Check token encapsulated in an AttestationTokenResponse.</p>
120128
<p class="toc_element">
121129
<code><a href="#exchangeRecaptchaToken">exchangeRecaptchaToken(app, body=None, x__xgafv=None)</a></code></p>
122130
<p class="firstline">Validates a [reCAPTCHA v3 response token](https://developers.google.com/recaptcha/docs/v3). If valid, returns an App Check token encapsulated in an AttestationTokenResponse.</p>
@@ -274,6 +282,33 @@ <h3>Method Details</h3>
274282
}</pre>
275283
</div>
276284

285+
<div class="method">
286+
<code class="details" id="exchangeRecaptchaEnterpriseToken">exchangeRecaptchaEnterpriseToken(app, body=None, x__xgafv=None)</code>
287+
<pre>Validates a [reCAPTCHA Enterprise response token](https://cloud.google.com/recaptcha-enterprise/docs/create-assessment#retrieve_token). If valid, returns an App Check token encapsulated in an AttestationTokenResponse.
288+
289+
Args:
290+
app: string, Required. The relative resource name of the web 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)
291+
body: object, The request body.
292+
The object takes the form of:
293+
294+
{ # Request message for the ExchangeRecaptchaEnterpriseToken method.
295+
&quot;recaptchaEnterpriseToken&quot;: &quot;A String&quot;, # Required. The reCAPTCHA token as returned by the [reCAPTCHA Enterprise JavaScript API](https://cloud.google.com/recaptcha-enterprise/docs/instrument-web-pages).
296+
}
297+
298+
x__xgafv: string, V1 error format.
299+
Allowed values
300+
1 - v1 error format
301+
2 - v2 error format
302+
303+
Returns:
304+
An object of the form:
305+
306+
{ # Encapsulates an *App Check token*, which are used to access Firebase services protected by App Check.
307+
&quot;attestationToken&quot;: &quot;A String&quot;, # An App Check token. App Check tokens are signed [JWTs](https://tools.ietf.org/html/rfc7519) containing claims that identify the attested app and Firebase project. This token is used to access Firebase services protected by App Check.
308+
&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.
309+
}</pre>
310+
</div>
311+
277312
<div class="method">
278313
<code class="details" id="exchangeRecaptchaToken">exchangeRecaptchaToken(app, body=None, x__xgafv=None)</code>
279314
<pre>Validates a [reCAPTCHA v3 response token](https://developers.google.com/recaptcha/docs/v3). If valid, returns an App Check token encapsulated in an AttestationTokenResponse.
Lines changed: 173 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,173 @@
1+
<html><body>
2+
<style>
3+
4+
body, h1, h2, h3, div, span, p, pre, a {
5+
margin: 0;
6+
padding: 0;
7+
border: 0;
8+
font-weight: inherit;
9+
font-style: inherit;
10+
font-size: 100%;
11+
font-family: inherit;
12+
vertical-align: baseline;
13+
}
14+
15+
body {
16+
font-size: 13px;
17+
padding: 1em;
18+
}
19+
20+
h1 {
21+
font-size: 26px;
22+
margin-bottom: 1em;
23+
}
24+
25+
h2 {
26+
font-size: 24px;
27+
margin-bottom: 1em;
28+
}
29+
30+
h3 {
31+
font-size: 20px;
32+
margin-bottom: 1em;
33+
margin-top: 1em;
34+
}
35+
36+
pre, code {
37+
line-height: 1.5;
38+
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39+
}
40+
41+
pre {
42+
margin-top: 0.5em;
43+
}
44+
45+
h1, h2, h3, p {
46+
font-family: Arial, sans serif;
47+
}
48+
49+
h1, h2, h3 {
50+
border-bottom: solid #CCC 1px;
51+
}
52+
53+
.toc_element {
54+
margin-top: 0.5em;
55+
}
56+
57+
.firstline {
58+
margin-left: 2 em;
59+
}
60+
61+
.method {
62+
margin-top: 1em;
63+
border: solid 1px #CCC;
64+
padding: 1em;
65+
background: #EEE;
66+
}
67+
68+
.details {
69+
font-weight: bold;
70+
font-size: 14px;
71+
}
72+
73+
</style>
74+
75+
<h1><a href="firebaseappcheck_v1beta.html">Firebase App Check API</a> . <a href="firebaseappcheck_v1beta.projects.html">projects</a> . <a href="firebaseappcheck_v1beta.projects.apps.html">apps</a> . <a href="firebaseappcheck_v1beta.projects.apps.recaptchaEnterpriseConfig.html">recaptchaEnterpriseConfig</a></h1>
76+
<h2>Instance Methods</h2>
77+
<p class="toc_element">
78+
<code><a href="#batchGet">batchGet(parent, names=None, x__xgafv=None)</a></code></p>
79+
<p class="firstline">Gets the RecaptchaEnterpriseConfigs for the specified list of apps atomically.</p>
80+
<p class="toc_element">
81+
<code><a href="#close">close()</a></code></p>
82+
<p class="firstline">Close httplib2 connections.</p>
83+
<p class="toc_element">
84+
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
85+
<p class="firstline">Gets the RecaptchaEnterpriseConfig for the specified app.</p>
86+
<p class="toc_element">
87+
<code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
88+
<p class="firstline">Updates the RecaptchaEnterpriseConfig for the specified app. While this configuration is incomplete or invalid, the app will be unable to exchange reCAPTCHA Enterprise tokens for App Check tokens.</p>
89+
<h3>Method Details</h3>
90+
<div class="method">
91+
<code class="details" id="batchGet">batchGet(parent, names=None, x__xgafv=None)</code>
92+
<pre>Gets the RecaptchaEnterpriseConfigs for the specified list of apps atomically.
93+
94+
Args:
95+
parent: string, Required. The parent project name shared by all RecaptchaEnterpriseConfigs being retrieved, in the format ``` projects/{project_number} ``` The parent collection in the `name` field of any resource being retrieved must match this field, or the entire batch fails. (required)
96+
names: string, Required. The relative resource names of the RecaptchaEnterpriseConfigs to retrieve, in the format: ``` projects/{project_number}/apps/{app_id}/recaptchaEnterpriseConfig ``` A maximum of 100 objects can be retrieved in a batch. (repeated)
97+
x__xgafv: string, V1 error format.
98+
Allowed values
99+
1 - v1 error format
100+
2 - v2 error format
101+
102+
Returns:
103+
An object of the form:
104+
105+
{ # Response message for the BatchGetRecaptchaEnterpriseConfigs method.
106+
&quot;configs&quot;: [ # RecaptchaEnterpriseConfigs retrieved.
107+
{ # An app&#x27;s reCAPTCHA Enterprise configuration object. This configuration is used by ExchangeRecaptchaEnterpriseToken to validate reCAPTCHA tokens issued to apps by reCAPTCHA Enterprise. It also controls certain properties of the returned App Check token, such as its ttl.
108+
&quot;name&quot;: &quot;A String&quot;, # Required. The relative resource name of the reCAPTCHA Enterprise configuration object, in the format: ``` projects/{project_number}/apps/{app_id}/recaptchaEnterpriseConfig ```
109+
&quot;siteKey&quot;: &quot;A String&quot;, # The score-based site key [created in reCAPTCHA Enterprise](https://cloud.google.com/recaptcha-enterprise/docs/create-key#creating_a_site_key) used to [invoke reCAPTCHA and generate the reCAPTCHA tokens](https://cloud.google.com/recaptcha-enterprise/docs/instrument-web-pages) for your application. Important: This is *not* the `site_secret` (as it is in reCAPTCHA v3), but rather your score-based reCAPTCHA Enterprise site key.
110+
&quot;tokenTtl&quot;: &quot;A String&quot;, # Specifies the duration for which App Check tokens exchanged from reCAPTCHA Enterprise tokens will be valid. If unset, a default value of 1 hour is assumed. Must be between 30 minutes and 7 days, inclusive.
111+
},
112+
],
113+
}</pre>
114+
</div>
115+
116+
<div class="method">
117+
<code class="details" id="close">close()</code>
118+
<pre>Close httplib2 connections.</pre>
119+
</div>
120+
121+
<div class="method">
122+
<code class="details" id="get">get(name, x__xgafv=None)</code>
123+
<pre>Gets the RecaptchaEnterpriseConfig for the specified app.
124+
125+
Args:
126+
name: string, Required. The relative resource name of the RecaptchaEnterpriseConfig, in the format: ``` projects/{project_number}/apps/{app_id}/recaptchaEnterpriseConfig ``` (required)
127+
x__xgafv: string, V1 error format.
128+
Allowed values
129+
1 - v1 error format
130+
2 - v2 error format
131+
132+
Returns:
133+
An object of the form:
134+
135+
{ # An app&#x27;s reCAPTCHA Enterprise configuration object. This configuration is used by ExchangeRecaptchaEnterpriseToken to validate reCAPTCHA tokens issued to apps by reCAPTCHA Enterprise. It also controls certain properties of the returned App Check token, such as its ttl.
136+
&quot;name&quot;: &quot;A String&quot;, # Required. The relative resource name of the reCAPTCHA Enterprise configuration object, in the format: ``` projects/{project_number}/apps/{app_id}/recaptchaEnterpriseConfig ```
137+
&quot;siteKey&quot;: &quot;A String&quot;, # The score-based site key [created in reCAPTCHA Enterprise](https://cloud.google.com/recaptcha-enterprise/docs/create-key#creating_a_site_key) used to [invoke reCAPTCHA and generate the reCAPTCHA tokens](https://cloud.google.com/recaptcha-enterprise/docs/instrument-web-pages) for your application. Important: This is *not* the `site_secret` (as it is in reCAPTCHA v3), but rather your score-based reCAPTCHA Enterprise site key.
138+
&quot;tokenTtl&quot;: &quot;A String&quot;, # Specifies the duration for which App Check tokens exchanged from reCAPTCHA Enterprise tokens will be valid. If unset, a default value of 1 hour is assumed. Must be between 30 minutes and 7 days, inclusive.
139+
}</pre>
140+
</div>
141+
142+
<div class="method">
143+
<code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>
144+
<pre>Updates the RecaptchaEnterpriseConfig for the specified app. While this configuration is incomplete or invalid, the app will be unable to exchange reCAPTCHA Enterprise tokens for App Check tokens.
145+
146+
Args:
147+
name: string, Required. The relative resource name of the reCAPTCHA Enterprise configuration object, in the format: ``` projects/{project_number}/apps/{app_id}/recaptchaEnterpriseConfig ``` (required)
148+
body: object, The request body.
149+
The object takes the form of:
150+
151+
{ # An app&#x27;s reCAPTCHA Enterprise configuration object. This configuration is used by ExchangeRecaptchaEnterpriseToken to validate reCAPTCHA tokens issued to apps by reCAPTCHA Enterprise. It also controls certain properties of the returned App Check token, such as its ttl.
152+
&quot;name&quot;: &quot;A String&quot;, # Required. The relative resource name of the reCAPTCHA Enterprise configuration object, in the format: ``` projects/{project_number}/apps/{app_id}/recaptchaEnterpriseConfig ```
153+
&quot;siteKey&quot;: &quot;A String&quot;, # The score-based site key [created in reCAPTCHA Enterprise](https://cloud.google.com/recaptcha-enterprise/docs/create-key#creating_a_site_key) used to [invoke reCAPTCHA and generate the reCAPTCHA tokens](https://cloud.google.com/recaptcha-enterprise/docs/instrument-web-pages) for your application. Important: This is *not* the `site_secret` (as it is in reCAPTCHA v3), but rather your score-based reCAPTCHA Enterprise site key.
154+
&quot;tokenTtl&quot;: &quot;A String&quot;, # Specifies the duration for which App Check tokens exchanged from reCAPTCHA Enterprise tokens will be valid. If unset, a default value of 1 hour is assumed. Must be between 30 minutes and 7 days, inclusive.
155+
}
156+
157+
updateMask: string, Required. A comma-separated list of names of fields in the RecaptchaEnterpriseConfig to update. Example: `site_key`.
158+
x__xgafv: string, V1 error format.
159+
Allowed values
160+
1 - v1 error format
161+
2 - v2 error format
162+
163+
Returns:
164+
An object of the form:
165+
166+
{ # An app&#x27;s reCAPTCHA Enterprise configuration object. This configuration is used by ExchangeRecaptchaEnterpriseToken to validate reCAPTCHA tokens issued to apps by reCAPTCHA Enterprise. It also controls certain properties of the returned App Check token, such as its ttl.
167+
&quot;name&quot;: &quot;A String&quot;, # Required. The relative resource name of the reCAPTCHA Enterprise configuration object, in the format: ``` projects/{project_number}/apps/{app_id}/recaptchaEnterpriseConfig ```
168+
&quot;siteKey&quot;: &quot;A String&quot;, # The score-based site key [created in reCAPTCHA Enterprise](https://cloud.google.com/recaptcha-enterprise/docs/create-key#creating_a_site_key) used to [invoke reCAPTCHA and generate the reCAPTCHA tokens](https://cloud.google.com/recaptcha-enterprise/docs/instrument-web-pages) for your application. Important: This is *not* the `site_secret` (as it is in reCAPTCHA v3), but rather your score-based reCAPTCHA Enterprise site key.
169+
&quot;tokenTtl&quot;: &quot;A String&quot;, # Specifies the duration for which App Check tokens exchanged from reCAPTCHA Enterprise tokens will be valid. If unset, a default value of 1 hour is assumed. Must be between 30 minutes and 7 days, inclusive.
170+
}</pre>
171+
</div>
172+
173+
</body></html>

0 commit comments

Comments
 (0)