File

src/apis/verifiedaccess/v1.ts

Index

Properties
Methods

Constructor

constructor(context: APIRequestContext)
Parameters :
Name Type Optional
context APIRequestContext No

Properties

context
Type : APIRequestContext

Methods

create
create(params: Params$Resource$Challenge$Create, options: StreamMethodOptions)

CreateChallenge API

// Before running the sample:
// - Enable the API at:
//   https://console.developers.google.com/apis/api/verifiedaccess.googleapis.com
// - Login into gcloud by running:
//   `$ gcloud auth application-default login`
// - Install the npm module by running:
//   `$ npm install googleapis`

const {google} = require('googleapis');
const verifiedaccess = google.verifiedaccess('v1');

async function main() {
  const auth = new google.auth.GoogleAuth({
    // Scopes can be specified either as an array or as a single, space-delimited string.
    scopes: ['https://www.googleapis.com/auth/verifiedaccess'],
  });

  // Acquire an auth client, and bind it to all future calls
  const authClient = await auth.getClient();
  google.options({auth: authClient});

  // Do the magic
  const res = await verifiedaccess.challenge.create({
    // Request body metadata
    requestBody: {
      // request body parameters
      // {}
    },
  });
  console.log(res.data);

  // Example response
  // {
  //   "alternativeChallenge": {},
  //   "challenge": {}
  // }
}

main().catch(e => {
  console.error(e);
  throw e;
});
Parameters :
Name Type Optional Description
params Params$Resource$Challenge$Create No
  • Parameters for request
options StreamMethodOptions No
  • Optionally override request options, such as url, method, and encoding.
Example :
<pre><code class="language-js">// Before running the sample:
// - Enable the API at:
//   https://console.developers.google.com/apis/api/verifiedaccess.googleapis.com
// - Login into gcloud by running:
//   `$ gcloud auth application-default login`
// - Install the npm module by running:
//   `$ npm install googleapis`

const {google} = require(&#39;googleapis&#39;);
const verifiedaccess = google.verifiedaccess(&#39;v1&#39;);

async function main() {
  const auth = new google.auth.GoogleAuth({
    // Scopes can be specified either as an array or as a single, space-delimited string.
    scopes: [&#39;https://www.googleapis.com/auth/verifiedaccess&#39;],
  });

  // Acquire an auth client, and bind it to all future calls
  const authClient = await auth.getClient();
  google.options({auth: authClient});

  // Do the magic
  const res = await verifiedaccess.challenge.create({
    // Request body metadata
    requestBody: {
      // request body parameters
      // {}
    },
  });
  console.log(res.data);

  // Example response
  // {
  //   &quot;alternativeChallenge&quot;: {},
  //   &quot;challenge&quot;: {}
  // }
}

main().catch(e =&gt; {
  console.error(e);
  throw e;
});
</code></pre>
Returns : GaxiosPromise<Readable>

A promise if used with async/await, or void if used with a callback.

create
create(params?: Params$Resource$Challenge$Create, options?: MethodOptions)
Parameters :
Name Type Optional
params Params$Resource$Challenge$Create Yes
options MethodOptions Yes
create
create(params: Params$Resource$Challenge$Create, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback)
Parameters :
Name Type Optional
params Params$Resource$Challenge$Create No
options StreamMethodOptions | BodyResponseCallback<Readable> No
callback BodyResponseCallback<Readable> No
Returns : void
create
create(params: Params$Resource$Challenge$Create, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback<Schema$Challenge>)
Parameters :
Name Type Optional
params Params$Resource$Challenge$Create No
options MethodOptions | BodyResponseCallback<Schema$Challenge> No
callback BodyResponseCallback<Schema$Challenge> No
Returns : void
create
create(params: Params$Resource$Challenge$Create, callback: BodyResponseCallback<Schema$Challenge>)
Parameters :
Name Type Optional
params Params$Resource$Challenge$Create No
callback BodyResponseCallback<Schema$Challenge> No
Returns : void
create
create(callback: BodyResponseCallback<Schema$Challenge>)
Parameters :
Name Type Optional
callback BodyResponseCallback<Schema$Challenge> No
Returns : void
create
create(paramsOrCallback?: Params$Resource$Challenge$Create | BodyResponseCallback<Schema$Challenge> | BodyResponseCallback<Readable>, optionsOrCallback?: MethodOptions | StreamMethodOptions | BodyResponseCallback | BodyResponseCallback, callback?: BodyResponseCallback<Schema$Challenge> | BodyResponseCallback<Readable>)
Parameters :
Name Type Optional
paramsOrCallback Params$Resource$Challenge$Create | BodyResponseCallback<Schema$Challenge> | BodyResponseCallback<Readable> Yes
optionsOrCallback MethodOptions | StreamMethodOptions | BodyResponseCallback<Schema$Challenge> | BodyResponseCallback<Readable> Yes
callback BodyResponseCallback<Schema$Challenge> | BodyResponseCallback<Readable> Yes
Returns : void | GaxiosPromise | GaxiosPromise
verify
verify(params: Params$Resource$Challenge$Verify, options: StreamMethodOptions)

VerifyChallengeResponse API

// Before running the sample:
// - Enable the API at:
//   https://console.developers.google.com/apis/api/verifiedaccess.googleapis.com
// - Login into gcloud by running:
//   `$ gcloud auth application-default login`
// - Install the npm module by running:
//   `$ npm install googleapis`

const {google} = require('googleapis');
const verifiedaccess = google.verifiedaccess('v1');

async function main() {
  const auth = new google.auth.GoogleAuth({
    // Scopes can be specified either as an array or as a single, space-delimited string.
    scopes: ['https://www.googleapis.com/auth/verifiedaccess'],
  });

  // Acquire an auth client, and bind it to all future calls
  const authClient = await auth.getClient();
  google.options({auth: authClient});

  // Do the magic
  const res = await verifiedaccess.challenge.verify({
    // Request body metadata
    requestBody: {
      // request body parameters
      // {
      //   "challengeResponse": {},
      //   "expectedIdentity": "my_expectedIdentity"
      // }
    },
  });
  console.log(res.data);

  // Example response
  // {
  //   "deviceEnrollmentId": "my_deviceEnrollmentId",
  //   "devicePermanentId": "my_devicePermanentId",
  //   "signedPublicKeyAndChallenge": "my_signedPublicKeyAndChallenge",
  //   "verificationOutput": "my_verificationOutput"
  // }
}

main().catch(e => {
  console.error(e);
  throw e;
});
Parameters :
Name Type Optional Description
params Params$Resource$Challenge$Verify No
  • Parameters for request
options StreamMethodOptions No
  • Optionally override request options, such as url, method, and encoding.
Example :
<pre><code class="language-js">// Before running the sample:
// - Enable the API at:
//   https://console.developers.google.com/apis/api/verifiedaccess.googleapis.com
// - Login into gcloud by running:
//   `$ gcloud auth application-default login`
// - Install the npm module by running:
//   `$ npm install googleapis`

const {google} = require(&#39;googleapis&#39;);
const verifiedaccess = google.verifiedaccess(&#39;v1&#39;);

async function main() {
  const auth = new google.auth.GoogleAuth({
    // Scopes can be specified either as an array or as a single, space-delimited string.
    scopes: [&#39;https://www.googleapis.com/auth/verifiedaccess&#39;],
  });

  // Acquire an auth client, and bind it to all future calls
  const authClient = await auth.getClient();
  google.options({auth: authClient});

  // Do the magic
  const res = await verifiedaccess.challenge.verify({
    // Request body metadata
    requestBody: {
      // request body parameters
      // {
      //   &quot;challengeResponse&quot;: {},
      //   &quot;expectedIdentity&quot;: &quot;my_expectedIdentity&quot;
      // }
    },
  });
  console.log(res.data);

  // Example response
  // {
  //   &quot;deviceEnrollmentId&quot;: &quot;my_deviceEnrollmentId&quot;,
  //   &quot;devicePermanentId&quot;: &quot;my_devicePermanentId&quot;,
  //   &quot;signedPublicKeyAndChallenge&quot;: &quot;my_signedPublicKeyAndChallenge&quot;,
  //   &quot;verificationOutput&quot;: &quot;my_verificationOutput&quot;
  // }
}

main().catch(e =&gt; {
  console.error(e);
  throw e;
});
</code></pre>
Returns : GaxiosPromise<Readable>

A promise if used with async/await, or void if used with a callback.

verify
verify(params?: Params$Resource$Challenge$Verify, options?: MethodOptions)
Parameters :
Name Type Optional
params Params$Resource$Challenge$Verify Yes
options MethodOptions Yes
verify
verify(params: Params$Resource$Challenge$Verify, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback)
Parameters :
Name Type Optional
params Params$Resource$Challenge$Verify No
options StreamMethodOptions | BodyResponseCallback<Readable> No
callback BodyResponseCallback<Readable> No
Returns : void
verify
verify(params: Params$Resource$Challenge$Verify, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback<Schema$VerifyChallengeResponseResult>)
Parameters :
Name Type Optional
params Params$Resource$Challenge$Verify No
options MethodOptions | BodyResponseCallback<Schema$VerifyChallengeResponseResult> No
callback BodyResponseCallback<Schema$VerifyChallengeResponseResult> No
Returns : void
verify
verify(params: Params$Resource$Challenge$Verify, callback: BodyResponseCallback<Schema$VerifyChallengeResponseResult>)
Returns : void
verify
verify(callback: BodyResponseCallback<Schema$VerifyChallengeResponseResult>)
Parameters :
Name Type Optional
callback BodyResponseCallback<Schema$VerifyChallengeResponseResult> No
Returns : void
verify
verify(paramsOrCallback?: Params$Resource$Challenge$Verify | BodyResponseCallback<Schema$VerifyChallengeResponseResult> | BodyResponseCallback<Readable>, optionsOrCallback?: MethodOptions | StreamMethodOptions | BodyResponseCallback | BodyResponseCallback, callback?: BodyResponseCallback<Schema$VerifyChallengeResponseResult> | BodyResponseCallback<Readable>)
Parameters :
Name Type Optional
paramsOrCallback Params$Resource$Challenge$Verify | BodyResponseCallback<Schema$VerifyChallengeResponseResult> | BodyResponseCallback<Readable> Yes
optionsOrCallback MethodOptions | StreamMethodOptions | BodyResponseCallback<Schema$VerifyChallengeResponseResult> | BodyResponseCallback<Readable> Yes
callback BodyResponseCallback<Schema$VerifyChallengeResponseResult> | BodyResponseCallback<Readable> Yes
Returns : void | GaxiosPromise | GaxiosPromise
import {
  OAuth2Client,
  JWT,
  Compute,
  UserRefreshClient,
  BaseExternalAccountClient,
  GaxiosPromise,
  GoogleConfigurable,
  createAPIRequest,
  MethodOptions,
  StreamMethodOptions,
  GlobalOptions,
  GoogleAuth,
  BodyResponseCallback,
  APIRequestContext,
} from 'googleapis-common';
import {Readable} from 'stream';

export namespace verifiedaccess_v1 {
  export interface Options extends GlobalOptions {
    version: 'v1';
  }

  interface StandardParameters {
    /**
     * Auth client or API Key for the request
     */
    auth?:
      | string
      | OAuth2Client
      | JWT
      | Compute
      | UserRefreshClient
      | BaseExternalAccountClient
      | GoogleAuth;

    /**
     * V1 error format.
     */
    '$.xgafv'?: string;
    /**
     * OAuth access token.
     */
    access_token?: string;
    /**
     * Data format for response.
     */
    alt?: string;
    /**
     * JSONP
     */
    callback?: string;
    /**
     * Selector specifying which fields to include in a partial response.
     */
    fields?: string;
    /**
     * API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
     */
    key?: string;
    /**
     * OAuth 2.0 token for the current user.
     */
    oauth_token?: string;
    /**
     * Returns response with indentations and line breaks.
     */
    prettyPrint?: boolean;
    /**
     * Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
     */
    quotaUser?: string;
    /**
     * Legacy upload protocol for media (e.g. "media", "multipart").
     */
    uploadType?: string;
    /**
     * Upload protocol for media (e.g. "raw", "multipart").
     */
    upload_protocol?: string;
  }

  /**
   * Chrome Verified Access API
   *
   * API for Verified Access chrome extension to provide credential verification for chrome devices connecting to an enterprise network
   *
   * @example
   * ```js
   * const {google} = require('googleapis');
   * const verifiedaccess = google.verifiedaccess('v1');
   * ```
   */
  export class Verifiedaccess {
    context: APIRequestContext;
    challenge: Resource$Challenge;

    constructor(options: GlobalOptions, google?: GoogleConfigurable) {
      this.context = {
        _options: options || {},
        google,
      };

      this.challenge = new Resource$Challenge(this.context);
    }
  }

  /**
   * Result message for VerifiedAccess.CreateChallenge.
   */
  export interface Schema$Challenge {
    /**
     * Challenge generated with the old signing key (this will only be present during key rotation)
     */
    alternativeChallenge?: Schema$SignedData;
    /**
     * Generated challenge
     */
    challenge?: Schema$SignedData;
  }
  /**
   * A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); \} The JSON representation for `Empty` is empty JSON object `{\}`.
   */
  export interface Schema$Empty {}
  /**
   * The wrapper message of any data and its signature.
   */
  export interface Schema$SignedData {
    /**
     * The data to be signed.
     */
    data?: string | null;
    /**
     * The signature of the data field.
     */
    signature?: string | null;
  }
  /**
   * signed ChallengeResponse
   */
  export interface Schema$VerifyChallengeResponseRequest {
    /**
     * The generated response to the challenge
     */
    challengeResponse?: Schema$SignedData;
    /**
     * Service can optionally provide identity information about the device or user associated with the key. For an EMK, this value is the enrolled domain. For an EUK, this value is the user's email address. If present, this value will be checked against contents of the response, and verification will fail if there is no match.
     */
    expectedIdentity?: string | null;
  }
  /**
   * Result message for VerifiedAccess.VerifyChallengeResponse.
   */
  export interface Schema$VerifyChallengeResponseResult {
    /**
     * Device enrollment id is returned in this field (for the machine response only).
     */
    deviceEnrollmentId?: string | null;
    /**
     * Device permanent id is returned in this field (for the machine response only).
     */
    devicePermanentId?: string | null;
    /**
     * Certificate Signing Request (in the SPKAC format, base64 encoded) is returned in this field. This field will be set only if device has included CSR in its challenge response. (the option to include CSR is now available for both user and machine responses)
     */
    signedPublicKeyAndChallenge?: string | null;
    /**
     * For EMCert check, device permanent id is returned here. For EUCert check, signed_public_key_and_challenge [base64 encoded] is returned if present, otherwise empty string is returned. This field is deprecated, please use device_permanent_id or signed_public_key_and_challenge fields.
     */
    verificationOutput?: string | null;
  }

  export class Resource$Challenge {
    context: APIRequestContext;
    constructor(context: APIRequestContext) {
      this.context = context;
    }

    /**
     * CreateChallenge API
     * @example
     * ```js
     * // Before running the sample:
     * // - Enable the API at:
     * //   https://console.developers.google.com/apis/api/verifiedaccess.googleapis.com
     * // - Login into gcloud by running:
     * //   `$ gcloud auth application-default login`
     * // - Install the npm module by running:
     * //   `$ npm install googleapis`
     *
     * const {google} = require('googleapis');
     * const verifiedaccess = google.verifiedaccess('v1');
     *
     * async function main() {
     *   const auth = new google.auth.GoogleAuth({
     *     // Scopes can be specified either as an array or as a single, space-delimited string.
     *     scopes: ['https://www.googleapis.com/auth/verifiedaccess'],
     *   });
     *
     *   // Acquire an auth client, and bind it to all future calls
     *   const authClient = await auth.getClient();
     *   google.options({auth: authClient});
     *
     *   // Do the magic
     *   const res = await verifiedaccess.challenge.create({
     *     // Request body metadata
     *     requestBody: {
     *       // request body parameters
     *       // {}
     *     },
     *   });
     *   console.log(res.data);
     *
     *   // Example response
     *   // {
     *   //   "alternativeChallenge": {},
     *   //   "challenge": {}
     *   // }
     * }
     *
     * main().catch(e => {
     *   console.error(e);
     *   throw e;
     * });
     *
     * ```
     *
     * @param params - Parameters for request
     * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
     * @param callback - Optional callback that handles the response.
     * @returns A promise if used with async/await, or void if used with a callback.
     */
    create(
      params: Params$Resource$Challenge$Create,
      options: StreamMethodOptions
    ): GaxiosPromise<Readable>;
    create(
      params?: Params$Resource$Challenge$Create,
      options?: MethodOptions
    ): GaxiosPromise<Schema$Challenge>;
    create(
      params: Params$Resource$Challenge$Create,
      options: StreamMethodOptions | BodyResponseCallback<Readable>,
      callback: BodyResponseCallback<Readable>
    ): void;
    create(
      params: Params$Resource$Challenge$Create,
      options: MethodOptions | BodyResponseCallback<Schema$Challenge>,
      callback: BodyResponseCallback<Schema$Challenge>
    ): void;
    create(
      params: Params$Resource$Challenge$Create,
      callback: BodyResponseCallback<Schema$Challenge>
    ): void;
    create(callback: BodyResponseCallback<Schema$Challenge>): void;
    create(
      paramsOrCallback?:
        | Params$Resource$Challenge$Create
        | BodyResponseCallback<Schema$Challenge>
        | BodyResponseCallback<Readable>,
      optionsOrCallback?:
        | MethodOptions
        | StreamMethodOptions
        | BodyResponseCallback<Schema$Challenge>
        | BodyResponseCallback<Readable>,
      callback?:
        | BodyResponseCallback<Schema$Challenge>
        | BodyResponseCallback<Readable>
    ): void | GaxiosPromise<Schema$Challenge> | GaxiosPromise<Readable> {
      let params = (paramsOrCallback || {}) as Params$Resource$Challenge$Create;
      let options = (optionsOrCallback || {}) as MethodOptions;

      if (typeof paramsOrCallback === 'function') {
        callback = paramsOrCallback;
        params = {} as Params$Resource$Challenge$Create;
        options = {};
      }

      if (typeof optionsOrCallback === 'function') {
        callback = optionsOrCallback;
        options = {};
      }

      const rootUrl =
        options.rootUrl || 'https://verifiedaccess.googleapis.com/';
      const parameters = {
        options: Object.assign(
          {
            url: (rootUrl + '/v1/challenge').replace(/([^:]\/)\/+/g, '$1'),
            method: 'POST',
          },
          options
        ),
        params,
        requiredParams: [],
        pathParams: [],
        context: this.context,
      };
      if (callback) {
        createAPIRequest<Schema$Challenge>(
          parameters,
          callback as BodyResponseCallback<unknown>
        );
      } else {
        return createAPIRequest<Schema$Challenge>(parameters);
      }
    }

    /**
     * VerifyChallengeResponse API
     * @example
     * ```js
     * // Before running the sample:
     * // - Enable the API at:
     * //   https://console.developers.google.com/apis/api/verifiedaccess.googleapis.com
     * // - Login into gcloud by running:
     * //   `$ gcloud auth application-default login`
     * // - Install the npm module by running:
     * //   `$ npm install googleapis`
     *
     * const {google} = require('googleapis');
     * const verifiedaccess = google.verifiedaccess('v1');
     *
     * async function main() {
     *   const auth = new google.auth.GoogleAuth({
     *     // Scopes can be specified either as an array or as a single, space-delimited string.
     *     scopes: ['https://www.googleapis.com/auth/verifiedaccess'],
     *   });
     *
     *   // Acquire an auth client, and bind it to all future calls
     *   const authClient = await auth.getClient();
     *   google.options({auth: authClient});
     *
     *   // Do the magic
     *   const res = await verifiedaccess.challenge.verify({
     *     // Request body metadata
     *     requestBody: {
     *       // request body parameters
     *       // {
     *       //   "challengeResponse": {},
     *       //   "expectedIdentity": "my_expectedIdentity"
     *       // }
     *     },
     *   });
     *   console.log(res.data);
     *
     *   // Example response
     *   // {
     *   //   "deviceEnrollmentId": "my_deviceEnrollmentId",
     *   //   "devicePermanentId": "my_devicePermanentId",
     *   //   "signedPublicKeyAndChallenge": "my_signedPublicKeyAndChallenge",
     *   //   "verificationOutput": "my_verificationOutput"
     *   // }
     * }
     *
     * main().catch(e => {
     *   console.error(e);
     *   throw e;
     * });
     *
     * ```
     *
     * @param params - Parameters for request
     * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
     * @param callback - Optional callback that handles the response.
     * @returns A promise if used with async/await, or void if used with a callback.
     */
    verify(
      params: Params$Resource$Challenge$Verify,
      options: StreamMethodOptions
    ): GaxiosPromise<Readable>;
    verify(
      params?: Params$Resource$Challenge$Verify,
      options?: MethodOptions
    ): GaxiosPromise<Schema$VerifyChallengeResponseResult>;
    verify(
      params: Params$Resource$Challenge$Verify,
      options: StreamMethodOptions | BodyResponseCallback<Readable>,
      callback: BodyResponseCallback<Readable>
    ): void;
    verify(
      params: Params$Resource$Challenge$Verify,
      options:
        | MethodOptions
        | BodyResponseCallback<Schema$VerifyChallengeResponseResult>,
      callback: BodyResponseCallback<Schema$VerifyChallengeResponseResult>
    ): void;
    verify(
      params: Params$Resource$Challenge$Verify,
      callback: BodyResponseCallback<Schema$VerifyChallengeResponseResult>
    ): void;
    verify(
      callback: BodyResponseCallback<Schema$VerifyChallengeResponseResult>
    ): void;
    verify(
      paramsOrCallback?:
        | Params$Resource$Challenge$Verify
        | BodyResponseCallback<Schema$VerifyChallengeResponseResult>
        | BodyResponseCallback<Readable>,
      optionsOrCallback?:
        | MethodOptions
        | StreamMethodOptions
        | BodyResponseCallback<Schema$VerifyChallengeResponseResult>
        | BodyResponseCallback<Readable>,
      callback?:
        | BodyResponseCallback<Schema$VerifyChallengeResponseResult>
        | BodyResponseCallback<Readable>
    ):
      | void
      | GaxiosPromise<Schema$VerifyChallengeResponseResult>
      | GaxiosPromise<Readable> {
      let params = (paramsOrCallback || {}) as Params$Resource$Challenge$Verify;
      let options = (optionsOrCallback || {}) as MethodOptions;

      if (typeof paramsOrCallback === 'function') {
        callback = paramsOrCallback;
        params = {} as Params$Resource$Challenge$Verify;
        options = {};
      }

      if (typeof optionsOrCallback === 'function') {
        callback = optionsOrCallback;
        options = {};
      }

      const rootUrl =
        options.rootUrl || 'https://verifiedaccess.googleapis.com/';
      const parameters = {
        options: Object.assign(
          {
            url: (rootUrl + '/v1/challenge:verify').replace(
              /([^:]\/)\/+/g,
              '$1'
            ),
            method: 'POST',
          },
          options
        ),
        params,
        requiredParams: [],
        pathParams: [],
        context: this.context,
      };
      if (callback) {
        createAPIRequest<Schema$VerifyChallengeResponseResult>(
          parameters,
          callback as BodyResponseCallback<unknown>
        );
      } else {
        return createAPIRequest<Schema$VerifyChallengeResponseResult>(
          parameters
        );
      }
    }
  }

  export interface Params$Resource$Challenge$Create extends StandardParameters {
    /**
     * Request body metadata
     */
    requestBody?: Schema$Empty;
  }
  export interface Params$Resource$Challenge$Verify extends StandardParameters {
    /**
     * Request body metadata
     */
    requestBody?: Schema$VerifyChallengeResponseRequest;
  }
}

result-matching ""

    No results matching ""