| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129 |
- // Copyright (c) Microsoft Corporation. All rights reserved.
- // Licensed under the MIT License. See License.txt in the project root for license information.
- import { MSITokenCredentials, MSIOptions, MSITokenResponse } from "./msiTokenCredentials";
- import { HttpOperationResponse, RequestPrepareOptions, WebResource } from "@azure/ms-rest-js";
- /**
- * @interface MSIAppServiceOptions Defines the optional parameters for authentication with MSI for AppService.
- */
- export interface MSIAppServiceOptions extends MSIOptions {
- /**
- * @property {string} [msiEndpoint] - The local URL from which your app can request tokens.
- * Either provide this parameter or set the environment variable `MSI_ENDPOINT`.
- * For example: `export MSI_ENDPOINT="http://127.0.0.1:41741/MSI/token/"`
- */
- msiEndpoint?: string;
- /**
- * @property {string} [msiSecret] - The secret used in communication between your code and the local MSI agent.
- * Either provide this parameter or set the environment variable `MSI_SECRET`.
- * For example: `export MSI_SECRET="69418689F1E342DD946CB82994CDA3CB"`
- */
- msiSecret?: string;
- /**
- * @property {string} [msiApiVersion] - The api-version of the local MSI agent. Default value is "2017-09-01".
- */
- msiApiVersion?: string;
- }
- /**
- * @class MSIAppServiceTokenCredentials
- */
- export class MSIAppServiceTokenCredentials extends MSITokenCredentials {
- /**
- * @property {string} msiEndpoint - The local URL from which your app can request tokens.
- * Either provide this parameter or set the environment variable `MSI_ENDPOINT`.
- * For example: `MSI_ENDPOINT="http://127.0.0.1:41741/MSI/token/"`
- */
- msiEndpoint: string;
- /**
- * @property {string} msiSecret - The secret used in communication between your code and the local MSI agent.
- * Either provide this parameter or set the environment variable `MSI_SECRET`.
- * For example: `MSI_SECRET="69418689F1E342DD946CB82994CDA3CB"`
- */
- msiSecret: string;
- /**
- * @property {string} [msiApiVersion] The api-version of the local MSI agent. Default value is "2017-09-01".
- */
- msiApiVersion?: string;
- /**
- * Creates an instance of MSIAppServiceTokenCredentials.
- * @param {string} [options.msiEndpoint] - The local URL from which your app can request tokens.
- * Either provide this parameter or set the environment variable `MSI_ENDPOINT`.
- * For example: `MSI_ENDPOINT="http://127.0.0.1:41741/MSI/token/"`
- * @param {string} [options.msiSecret] - The secret used in communication between your code and the local MSI agent.
- * Either provide this parameter or set the environment variable `MSI_SECRET`.
- * For example: `MSI_SECRET="69418689F1E342DD946CB82994CDA3CB"`
- * @param {string} [options.resource] - The resource uri or token audience for which the token is needed.
- * For e.g. it can be:
- * - resource management endpoint "https://management.azure.com/" (default)
- * - management endpoint "https://management.core.windows.net/"
- * @param {string} [options.msiApiVersion] - The api-version of the local MSI agent. Default value is "2017-09-01".
- */
- constructor(options?: MSIAppServiceOptions) {
- if (!options) options = {};
- super(options);
- options.msiEndpoint = options.msiEndpoint || process.env["MSI_ENDPOINT"];
- options.msiSecret = options.msiSecret || process.env["MSI_SECRET"];
- if (!options.msiEndpoint || (options.msiEndpoint && typeof options.msiEndpoint.valueOf() !== "string")) {
- throw new Error('Either provide "msiEndpoint" as a property of the "options" object ' +
- 'or set the environment variable "MSI_ENDPOINT" and it must be of type "string".');
- }
- if (!options.msiSecret || (options.msiSecret && typeof options.msiSecret.valueOf() !== "string")) {
- throw new Error('Either provide "msiSecret" as a property of the "options" object ' +
- 'or set the environment variable "MSI_SECRET" and it must be of type "string".');
- }
- if (!options.msiApiVersion) {
- options.msiApiVersion = "2017-09-01";
- } else if (typeof options.msiApiVersion.valueOf() !== "string") {
- throw new Error("msiApiVersion must be a uri.");
- }
- this.msiEndpoint = options.msiEndpoint;
- this.msiSecret = options.msiSecret;
- this.msiApiVersion = options.msiApiVersion;
- }
- /**
- * Prepares and sends a GET request to a service endpoint indicated by the app service, which responds with the access token.
- * @return {Promise<MSITokenResponse>} Promise with the tokenResponse (tokenType and accessToken are the two important properties).
- */
- async getToken(): Promise<MSITokenResponse> {
- const reqOptions = this.prepareRequestOptions();
- let opRes: HttpOperationResponse;
- let result: MSITokenResponse;
- opRes = await this._httpClient.sendRequest(reqOptions);
- if (opRes.bodyAsText === undefined || opRes.bodyAsText!.indexOf("ExceptionMessage") !== -1) {
- throw new Error(`MSI: Failed to retrieve a token from "${reqOptions.url}" with an error: ${opRes.bodyAsText}`);
- }
- result = this.parseTokenResponse(opRes.bodyAsText!) as MSITokenResponse;
- if (!result.tokenType) {
- throw new Error(`Invalid token response, did not find tokenType. Response body is: ${opRes.bodyAsText}`);
- } else if (!result.accessToken) {
- throw new Error(`Invalid token response, did not find accessToken. Response body is: ${opRes.bodyAsText}`);
- }
- return result;
- }
- protected prepareRequestOptions(): WebResource {
- const endpoint = this.msiEndpoint.endsWith("/") ? this.msiEndpoint : `${this.msiEndpoint}/`;
- const resource = encodeURIComponent(this.resource);
- const getUrl = `${endpoint}?resource=${resource}&api-version=${this.msiApiVersion}`;
- const reqOptions: RequestPrepareOptions = {
- url: getUrl,
- headers: {
- "secret": this.msiSecret
- },
- method: "GET"
- };
- const webResource = new WebResource();
- return webResource.prepare(reqOptions);
- }
- }
|