@microsoft/vscode-azext-azureauth 1.1.3 → 1.2.2

package/README.md

@@ -13,6 +13,14 @@ The `AzureSubscriptionProvider` interface describes the functions of this packag
  * An interface for obtaining Azure subscription information
  */
 export interface AzureSubscriptionProvider {
+    /**
+     * Gets a list of tenants available to the user.
+     * Use {@link isSignedIn} to check if the user is signed in to a particular tenant.
+     *
+     * @returns A list of tenants.
+     */
+    getTenants(): Promise<TenantIdDescription[]>;
+
     /**
      * Gets a list of Azure subscriptions available to the user.
      *
@@ -30,16 +38,20 @@ export interface AzureSubscriptionProvider {
     /**
      * Checks to see if a user is signed in.
      *
+     * @param tenantId (Optional) Provide to check if a user is signed in to a specific tenant.
+     *
      * @returns True if the user is signed in, false otherwise.
      */
-    isSignedIn(): Promise<boolean>;
+    isSignedIn(tenantId?: string): Promise<boolean>;
 
     /**
      * Asks the user to sign in or pick an account to use.
      *
+     * @param tenantId (Optional) Provide to sign in to a specific tenant.
+     *
      * @returns True if the user is signed in, false otherwise.
      */
-    signIn(): Promise<boolean>;
+    signIn(tenantId?: string): Promise<boolean>;
 
     /**
      * An event that is fired when the user signs in. Debounced to fire at most once every 5 seconds.
@@ -88,6 +100,12 @@ export declare function getConfiguredAzureEnv(): azureEnv.Environment & {
 export declare function setConfiguredAzureEnv(cloud: string | azureEnv.EnvironmentParameters, target?: vscode.ConfigurationTarget): Promise<void>;
 ```
 
+## Logs
+
+View the Microsoft Authentication extension logs by running the `Developer: Show Logs...` command from the VS Code command palette.
+
+Change the log level by running the `Developer: Set Log Level...` command from the VS Code command palette. Select `Microsoft Authentication` from the list of loggers and then select the desired log level.
+
 ## License
 
 [MIT](LICENSE.md)

package/out/src/AzureSubscriptionProvider.d.ts

@@ -1,9 +1,17 @@
 import type * as vscode from 'vscode';
 import type { AzureSubscription } from './AzureSubscription';
+import { TenantIdDescription } from '@azure/arm-subscriptions';
 /**
  * An interface for obtaining Azure subscription information
  */
 export interface AzureSubscriptionProvider {
+    /**
+     * Gets a list of tenants available to the user.
+     * Use {@link isSignedIn} to check if the user is signed in to a particular tenant.
+     *
+     * @returns A list of tenants.
+     */
+    getTenants(): Promise<TenantIdDescription[]>;
     /**
      * Gets a list of Azure subscriptions available to the user.
      *
@@ -20,15 +28,19 @@ export interface AzureSubscriptionProvider {
     /**
      * Checks to see if a user is signed in.
      *
+     * @param tenantId (Optional) Provide to check if a user is signed in to a specific tenant.
+     *
      * @returns True if the user is signed in, false otherwise.
      */
-    isSignedIn(): Promise<boolean>;
+    isSignedIn(tenantId?: string): Promise<boolean>;
     /**
      * Asks the user to sign in or pick an account to use.
      *
+     * @param tenantId (Optional) Provide to sign in to a specific tenant.
+     *
      * @returns True if the user is signed in, false otherwise.
      */
-    signIn(): Promise<boolean>;
+    signIn(tenantId?: string): Promise<boolean>;
     /**
      * An event that is fired when the user signs in. Debounced to fire at most once every 5 seconds.
      */

package/out/src/VSCodeAzureSubscriptionProvider.d.ts

@@ -1,3 +1,4 @@
+import type { TenantIdDescription } from '@azure/arm-subscriptions';
 import * as vscode from 'vscode';
 import type { AzureSubscription, SubscriptionId, TenantId } from './AzureSubscription';
 import type { AzureSubscriptionProvider } from './AzureSubscriptionProvider';
@@ -12,6 +13,13 @@ export declare class VSCodeAzureSubscriptionProvider extends vscode.Disposable i
     private readonly onDidSignOutEmitter;
     private lastSignOutEventFired;
     constructor();
+    /**
+     * Gets a list of tenants available to the user.
+     * Use {@link isSignedIn} to check if the user is signed in to a particular tenant.
+     *
+     * @returns A list of tenants.
+     */
+    getTenants(): Promise<TenantIdDescription[]>;
     /**
      * Gets a list of Azure subscriptions available to the user.
      *
@@ -36,9 +44,11 @@ export declare class VSCodeAzureSubscriptionProvider extends vscode.Disposable i
     /**
      * Asks the user to sign in or pick an account to use.
      *
+     * @param tenantId (Optional) Provide to sign in to a specific tenant.
+     *
      * @returns True if the user is signed in, false otherwise.
      */
-    signIn(): Promise<boolean>;
+    signIn(tenantId?: string): Promise<boolean>;
     /**
      * An event that is fired when the user signs in. Debounced to fire at most once every 5 seconds.
      */
@@ -73,12 +83,6 @@ export declare class VSCodeAzureSubscriptionProvider extends vscode.Disposable i
      * @returns A list of subscription IDs that are configured in `azureResourceGroups.selectedSubscriptions`.
      */
     protected getSubscriptionFilters(): Promise<SubscriptionId[]>;
-    /**
-     * Gets the tenants available to a user.
-     *
-     * @returns The list of tenants visible to the user.
-     */
-    private getTenants;
     /**
      * Gets the subscriptions for a given tenant.
      *
@@ -95,20 +99,5 @@ export declare class VSCodeAzureSubscriptionProvider extends vscode.Disposable i
      * @returns A client, the credential used by the client, and the authentication function
      */
     private getSubscriptionClient;
-    /**
-     * Gets a normalized list of scopes
-     *
-     * @param scopes An input scope string, list, or undefined
-     * @param tenantId (Optional) The tenant ID, will be added to the scopes
-     *
-     * @returns A list of scopes, with the default scope and (optionally) the tenant scope added
-     */
-    private getScopes;
-    /**
-     * Gets the default Azure scopes required for resource management,
-     * depending on the configured endpoint
-     *
-     * @returns The default Azure scopes required
-     */
-    private getDefaultScopes;
+    private getToken;
 }

package/out/src/VSCodeAzureSubscriptionProvider.js

@@ -21,8 +21,10 @@ var __asyncValues = (this && this.__asyncValues) || function (o) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VSCodeAzureSubscriptionProvider = void 0;
+const cross_fetch_1 = require("cross-fetch");
 const vscode = require("vscode");
 const NotSignedInError_1 = require("./NotSignedInError");
+const getSessionFromVSCode_1 = require("./getSessionFromVSCode");
 const configuredAzureEnv_1 = require("./utils/configuredAzureEnv");
 const EventDebounce = 5 * 1000; // 5 seconds
 /**
@@ -66,6 +68,22 @@ class VSCodeAzureSubscriptionProvider extends vscode.Disposable {
          */
         this.onDidSignOut = this.onDidSignOutEmitter.event;
     }
+    /**
+     * Gets a list of tenants available to the user.
+     * Use {@link isSignedIn} to check if the user is signed in to a particular tenant.
+     *
+     * @returns A list of tenants.
+     */
+    getTenants() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const listTenantsResponse = yield (0, cross_fetch_1.default)('https://management.azure.com/tenants?api-version=2022-12-01', {
+                headers: {
+                    Authorization: `Bearer ${yield this.getToken()}`,
+                }
+            });
+            return (yield listTenantsResponse.json()).value;
+        });
+    }
     /**
      * Gets a list of Azure subscriptions available to the user.
      *
@@ -124,18 +142,20 @@ class VSCodeAzureSubscriptionProvider extends vscode.Disposable {
      */
     isSignedIn(tenantId) {
         return __awaiter(this, void 0, void 0, function* () {
-            const session = yield vscode.authentication.getSession((0, configuredAzureEnv_1.getConfiguredAuthProviderId)(), this.getScopes([], tenantId), { createIfNone: false, silent: true });
+            const session = yield (0, getSessionFromVSCode_1.getSessionFromVSCode)([], tenantId, { createIfNone: false, silent: true });
             return !!session;
         });
     }
     /**
      * Asks the user to sign in or pick an account to use.
      *
+     * @param tenantId (Optional) Provide to sign in to a specific tenant.
+     *
      * @returns True if the user is signed in, false otherwise.
      */
-    signIn() {
+    signIn(tenantId) {
         return __awaiter(this, void 0, void 0, function* () {
-            const session = yield vscode.authentication.getSession((0, configuredAzureEnv_1.getConfiguredAuthProviderId)(), this.getDefaultScopes(), { createIfNone: true, clearSessionPreference: true });
+            const session = yield (0, getSessionFromVSCode_1.getSessionFromVSCode)([], tenantId, { createIfNone: true, clearSessionPreference: true });
             return !!session;
         });
     }
@@ -179,39 +199,6 @@ class VSCodeAzureSubscriptionProvider extends vscode.Disposable {
             return fullSubscriptionIds.map(id => id.split('/')[1]);
         });
     }
-    /**
-     * Gets the tenants available to a user.
-     *
-     * @returns The list of tenants visible to the user.
-     */
-    getTenants() {
-        var _a, e_1, _b, _c;
-        return __awaiter(this, void 0, void 0, function* () {
-            const { client } = yield this.getSubscriptionClient();
-            const tenants = [];
-            try {
-                for (var _d = true, _e = __asyncValues(client.tenants.list()), _f; _f = yield _e.next(), _a = _f.done, !_a;) {
-                    _c = _f.value;
-                    _d = false;
-                    try {
-                        const tenant = _c;
-                        tenants.push(tenant);
-                    }
-                    finally {
-                        _d = true;
-                    }
-                }
-            }
-            catch (e_1_1) { e_1 = { error: e_1_1 }; }
-            finally {
-                try {
-                    if (!_d && !_a && (_b = _e.return)) yield _b.call(_e);
-                }
-                finally { if (e_1) throw e_1.error; }
-            }
-            return tenants;
-        });
-    }
     /**
      * Gets the subscriptions for a given tenant.
      *
@@ -220,7 +207,7 @@ class VSCodeAzureSubscriptionProvider extends vscode.Disposable {
      * @returns The list of subscriptions for the tenant.
      */
     getSubscriptionsForTenant(tenantId) {
-        var _a, e_2, _b, _c;
+        var _a, e_1, _b, _c;
         return __awaiter(this, void 0, void 0, function* () {
             const { client, credential, authentication } = yield this.getSubscriptionClient(tenantId);
             const environment = (0, configuredAzureEnv_1.getConfiguredAzureEnv)();
@@ -248,12 +235,12 @@ class VSCodeAzureSubscriptionProvider extends vscode.Disposable {
                     }
                 }
             }
-            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
             finally {
                 try {
                     if (!_d && !_a && (_b = _e.return)) yield _b.call(_e);
                 }
-                finally { if (e_2) throw e_2.error; }
+                finally { if (e_1) throw e_1.error; }
             }
             return subscriptions;
         });
@@ -268,17 +255,17 @@ class VSCodeAzureSubscriptionProvider extends vscode.Disposable {
     getSubscriptionClient(tenantId) {
         return __awaiter(this, void 0, void 0, function* () {
             const armSubs = yield Promise.resolve().then(() => require('@azure/arm-subscriptions'));
-            // This gets filled in when the client calls `getToken`, and then it can be returned in the `authentication` property of `AzureSubscription`
-            let session;
+            const getSession = (scopes) => __awaiter(this, void 0, void 0, function* () {
+                const session = yield (0, getSessionFromVSCode_1.getSessionFromVSCode)(scopes, tenantId, { createIfNone: false, silent: true });
+                if (!session) {
+                    throw new NotSignedInError_1.NotSignedInError();
+                }
+                return session;
+            });
             const credential = {
                 getToken: (scopes) => __awaiter(this, void 0, void 0, function* () {
-                    // TODO: if possible, change to `getSessions` when that API is available: https://github.com/microsoft/vscode/issues/152399
-                    session = yield vscode.authentication.getSession((0, configuredAzureEnv_1.getConfiguredAuthProviderId)(), this.getScopes(scopes, tenantId), { createIfNone: false, silent: true });
-                    if (!session) {
-                        throw new NotSignedInError_1.NotSignedInError();
-                    }
                     return {
-                        token: session.accessToken,
+                        token: (yield getSession(scopes)).accessToken,
                         expiresOnTimestamp: 0
                     };
                 })
@@ -287,41 +274,19 @@ class VSCodeAzureSubscriptionProvider extends vscode.Disposable {
                 client: new armSubs.SubscriptionClient(credential),
                 credential: credential,
                 authentication: {
-                    getSession: () => session // Rewrapped to make TS not confused about the weird initialization pattern
+                    getSession,
                 }
             };
         });
     }
-    /**
-     * Gets a normalized list of scopes
-     *
-     * @param scopes An input scope string, list, or undefined
-     * @param tenantId (Optional) The tenant ID, will be added to the scopes
-     *
-     * @returns A list of scopes, with the default scope and (optionally) the tenant scope added
-     */
-    getScopes(scopes, tenantId) {
-        const scopeSet = new Set(this.getDefaultScopes());
-        // If `.default` is passed in, it will be ignored, in favor of the correct default added by `getDefaultScopes`
-        if (typeof scopes === 'string' && scopes !== '.default') {
-            scopeSet.add(scopes);
-        }
-        else if (Array.isArray(scopes)) {
-            scopes.filter(scope => scope !== '.default').forEach(scope => scopeSet.add(scope));
-        }
-        if (tenantId) {
-            scopeSet.add(`VSCODE_TENANT:${tenantId}`);
-        }
-        return Array.from(scopeSet);
-    }
-    /**
-     * Gets the default Azure scopes required for resource management,
-     * depending on the configured endpoint
-     *
-     * @returns The default Azure scopes required
-     */
-    getDefaultScopes() {
-        return [`${(0, configuredAzureEnv_1.getConfiguredAzureEnv)().resourceManagerEndpointUrl}.default`];
+    getToken(tenantId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const session = yield (0, getSessionFromVSCode_1.getSessionFromVSCode)([], tenantId, { createIfNone: false, silent: true });
+            if (!session) {
+                throw new NotSignedInError_1.NotSignedInError();
+            }
+            return session.accessToken;
+        });
     }
 }
 exports.VSCodeAzureSubscriptionProvider = VSCodeAzureSubscriptionProvider;

package/out/src/getSessionFromVSCode.d.ts

@@ -0,0 +1,12 @@
+import * as vscode from "vscode";
+/**
+ * Wraps {@link vscode.authentication.getSession} and handles:
+ * * Passing the configured auth provider id
+ * * Getting the list of scopes, adding the tenant id to the scope list if needed
+ *
+ * @param scopes - top-level resource scopes (e.g. http://management.azure.com, http://storage.azure.com) or .default scopes. All resources/scopes will be normalized to the `.default` scope for each resource.
+ * @param tenantId - (Optional) The tenant ID, will be added to the scopes
+ * @param options - see {@link vscode.AuthenticationGetSessionOptions}
+ * @returns An authentication session if available, or undefined if there are no sessions
+ */
+export declare function getSessionFromVSCode(scopes?: string | string[], tenantId?: string, options?: vscode.AuthenticationGetSessionOptions): Promise<vscode.AuthenticationSession | undefined>;

package/out/src/getSessionFromVSCode.js

@@ -0,0 +1,62 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+*  Copyright (c) Microsoft Corporation. All rights reserved.
+*  Licensed under the MIT License. See License.txt in the project root for license information.
+*--------------------------------------------------------------------------------------------*/
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSessionFromVSCode = void 0;
+const configuredAzureEnv_1 = require("./utils/configuredAzureEnv");
+const vscode = require("vscode");
+function getResourceScopes(scopes) {
+    if (scopes === undefined || scopes === "" || scopes.length === 0) {
+        scopes = `${(0, configuredAzureEnv_1.getConfiguredAzureEnv)().resourceManagerEndpointUrl}.default`;
+    }
+    const arrScopes = (Array.isArray(scopes) ? scopes : [scopes])
+        .map((scope) => {
+        if (scope.endsWith('.default')) {
+            return scope;
+        }
+        else {
+            return `${scope}.default`;
+        }
+    });
+    return Array.from(new Set(arrScopes));
+}
+function addTenantIdScope(scopes, tenantId) {
+    const scopeSet = new Set(scopes);
+    scopeSet.add(`VSCODE_TENANT:${tenantId}`);
+    return Array.from(scopeSet);
+}
+function getScopes(scopes, tenantId) {
+    let scopeArr = getResourceScopes(scopes);
+    if (tenantId) {
+        scopeArr = addTenantIdScope(scopeArr, tenantId);
+    }
+    return scopeArr;
+}
+/**
+ * Wraps {@link vscode.authentication.getSession} and handles:
+ * * Passing the configured auth provider id
+ * * Getting the list of scopes, adding the tenant id to the scope list if needed
+ *
+ * @param scopes - top-level resource scopes (e.g. http://management.azure.com, http://storage.azure.com) or .default scopes. All resources/scopes will be normalized to the `.default` scope for each resource.
+ * @param tenantId - (Optional) The tenant ID, will be added to the scopes
+ * @param options - see {@link vscode.AuthenticationGetSessionOptions}
+ * @returns An authentication session if available, or undefined if there are no sessions
+ */
+function getSessionFromVSCode(scopes, tenantId, options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return yield vscode.authentication.getSession((0, configuredAzureEnv_1.getConfiguredAuthProviderId)(), getScopes(scopes, tenantId), options);
+    });
+}
+exports.getSessionFromVSCode = getSessionFromVSCode;
+//# sourceMappingURL=getSessionFromVSCode.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@microsoft/vscode-azext-azureauth",
     "author": "Microsoft Corporation",
-    "version": "1.1.3",
+    "version": "1.2.2",
     "description": "Azure authentication helpers for Visual Studio Code",
     "tags": [
         "azure",
@@ -52,6 +52,7 @@
     },
     "dependencies": {
         "@azure/arm-subscriptions": "^5.1.0",
-        "@azure/ms-rest-azure-env": "^2.0.0"
+        "@azure/ms-rest-azure-env": "^2.0.0",
+        "cross-fetch": "^4.0.0"
     }
 }