@maxim_mazurok/gapi.client.securityposture-v1 0.0.20241212
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/index.d.ts +1355 -0
- package/package.json +20 -0
- package/readme.md +73 -0
package/package.json
ADDED
@@ -0,0 +1,20 @@
|
|
1
|
+
{
|
2
|
+
"name": "@maxim_mazurok/gapi.client.securityposture-v1",
|
3
|
+
"version": "0.0.20241212",
|
4
|
+
"description": "TypeScript typings for Security Posture API v1",
|
5
|
+
"repository": {
|
6
|
+
"type": "git",
|
7
|
+
"url": "https://github.com/Maxim-Mazurok/google-api-typings-generator.git"
|
8
|
+
},
|
9
|
+
"license": "MIT",
|
10
|
+
"author": {
|
11
|
+
"name": "Maxim Mazurok",
|
12
|
+
"email": "maxim@mazurok.com",
|
13
|
+
"url": "https://maxim.mazurok.com"
|
14
|
+
},
|
15
|
+
"types": "index.d.ts",
|
16
|
+
"dependencies": {
|
17
|
+
"@types/gapi.client": "*",
|
18
|
+
"@types/gapi.client.discovery-v1": "*"
|
19
|
+
}
|
20
|
+
}
|
package/readme.md
ADDED
@@ -0,0 +1,73 @@
|
|
1
|
+
# TypeScript typings for Security Posture API v1
|
2
|
+
|
3
|
+
Defines, assesses, and monitors the overall status of your security in Google Cloud. You can use security postures to evaluate your current cloud security against defined benchmarks and help maintain the level of security that your organization requires.
|
4
|
+
For detailed description please check [documentation](https://cloud.google.com/security-command-center).
|
5
|
+
|
6
|
+
## Installing
|
7
|
+
|
8
|
+
Install typings for Security Posture API:
|
9
|
+
|
10
|
+
```
|
11
|
+
npm install @types/gapi.client.securityposture-v1 --save-dev
|
12
|
+
```
|
13
|
+
|
14
|
+
## Usage
|
15
|
+
|
16
|
+
You need to initialize Google API client in your code:
|
17
|
+
|
18
|
+
```typescript
|
19
|
+
gapi.load('client', () => {
|
20
|
+
// now we can use gapi.client
|
21
|
+
// ...
|
22
|
+
});
|
23
|
+
```
|
24
|
+
|
25
|
+
Then load api client wrapper:
|
26
|
+
|
27
|
+
```typescript
|
28
|
+
gapi.client.load(
|
29
|
+
'https://securityposture.googleapis.com/$discovery/rest?version=v1',
|
30
|
+
() => {
|
31
|
+
// now we can use:
|
32
|
+
// gapi.client.securityposture
|
33
|
+
}
|
34
|
+
);
|
35
|
+
```
|
36
|
+
|
37
|
+
```typescript
|
38
|
+
// Deprecated, use discovery document URL, see https://github.com/google/google-api-javascript-client/blob/master/docs/reference.md#----gapiclientloadname----version----callback--
|
39
|
+
gapi.client.load('securityposture', 'v1', () => {
|
40
|
+
// now we can use:
|
41
|
+
// gapi.client.securityposture
|
42
|
+
});
|
43
|
+
```
|
44
|
+
|
45
|
+
Don't forget to authenticate your client before sending any request to resources:
|
46
|
+
|
47
|
+
```typescript
|
48
|
+
// declare client_id registered in Google Developers Console
|
49
|
+
var client_id = '',
|
50
|
+
scope = [
|
51
|
+
// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account.
|
52
|
+
'https://www.googleapis.com/auth/cloud-platform',
|
53
|
+
],
|
54
|
+
immediate = true;
|
55
|
+
// ...
|
56
|
+
|
57
|
+
gapi.auth.authorize(
|
58
|
+
{client_id: client_id, scope: scope, immediate: immediate},
|
59
|
+
authResult => {
|
60
|
+
if (authResult && !authResult.error) {
|
61
|
+
/* handle successful authorization */
|
62
|
+
} else {
|
63
|
+
/* handle authorization error */
|
64
|
+
}
|
65
|
+
}
|
66
|
+
);
|
67
|
+
```
|
68
|
+
|
69
|
+
After that you can use Security Posture API resources: <!-- TODO: make this work for multiple namespaces -->
|
70
|
+
|
71
|
+
```typescript
|
72
|
+
|
73
|
+
```
|