/*--------------------------------------------------------------------------------------------- * Copyright (c) Microsoft Corporation. All rights reserved. * Licensed under the Source EULA. See License.txt in the project root for license information. *--------------------------------------------------------------------------------------------*/ import * as vscode from 'vscode'; import * as querystring from 'querystring'; import * as path from 'path'; import { isSupportedEnvironment } from './utils'; import { generateCodeChallenge, generateCodeVerifier, randomUUID } from './cryptoUtils'; import { BetterTokenStorage, IDidChangeInOtherWindowEvent } from './betterSecretStorage'; import { LoopbackAuthServer } from './node/authServer'; import { base64Decode } from './node/buffer'; import { fetching } from './node/fetch'; import { UriEventHandler } from './UriEventHandler'; import TelemetryReporter from '@vscode/extension-telemetry'; const redirectUrl = 'https://vscode-redirect.azurewebsites.net/'; const defaultLoginEndpointUrl = 'https://login.microsoftonline.com/'; const DEFAULT_CLIENT_ID = 'aebc6443-996d-45c2-90f0-388ff96faa56'; const DEFAULT_TENANT = 'organizations'; const MSA_TID = '9188040d-6c67-4c5b-b112-36a304b66dad'; const MSA_PASSTHRU_TID = 'f8cdef31-a31e-4b4a-93e4-5f571e91255a'; const enum MicrosoftAccountType { AAD = 'aad', MSA = 'msa', Unknown = 'unknown' } interface IToken { accessToken?: string; // When unable to refresh due to network problems, the access token becomes undefined idToken?: string; // depending on the scopes can be either supplied or empty expiresIn?: number; // How long access token is valid, in seconds expiresAt?: number; // UNIX epoch time at which token will expire refreshToken: string; account: { label: string; id: string; type: MicrosoftAccountType; }; scope: string; sessionId: string; // The account id + the scope } export interface IStoredSession { id: string; refreshToken: string; scope: string; // Scopes are alphabetized and joined with a space account: { label: string; id: string; }; endpoint: string | undefined; } export interface ITokenResponse { access_token: string; expires_in: number; ext_expires_in: number; refresh_token: string; scope: string; token_type: string; id_token?: string; } export interface IMicrosoftTokens { accessToken: string; idToken?: string; } interface IScopeData { originalScopes?: string[]; scopes: string[]; scopeStr: string; scopesToSend: string; clientId: string; tenant: string; } export const REFRESH_NETWORK_FAILURE = 'Network failure'; export class AzureActiveDirectoryService { // For details on why this is set to 2/3... see https://github.com/microsoft/vscode/issues/133201#issuecomment-966668197 private static REFRESH_TIMEOUT_MODIFIER = 1000 * 2 / 3; private static POLLING_CONSTANT = 1000 * 60 * 30; private _tokens: IToken[] = []; private _refreshTimeouts: Map = new Map(); private _refreshingPromise: Promise | undefined; private _sessionChangeEmitter: vscode.EventEmitter = new vscode.EventEmitter(); // Used to keep track of current requests when not using the local server approach. private _pendingNonces = new Map(); private _codeExchangePromises = new Map>(); private _codeVerfifiers = new Map(); constructor( private readonly _logger: vscode.LogOutputChannel, _context: vscode.ExtensionContext, private readonly _uriHandler: UriEventHandler, private readonly _tokenStorage: BetterTokenStorage, private readonly _telemetryReporter: TelemetryReporter, private readonly _loginEndpointUrl: string = defaultLoginEndpointUrl ) { _context.subscriptions.push(this._tokenStorage.onDidChangeInOtherWindow((e) => this.checkForUpdates(e))); } public async initialize(): Promise { this._logger.info('Reading sessions from secret storage...'); const sessions = await this._tokenStorage.getAll(item => this.sessionMatchesEndpoint(item)); this._logger.info(`Got ${sessions.length} stored sessions`); const refreshes = sessions.map(async session => { this._logger.trace(`Read the following stored session with scopes: ${session.scope}`); const scopes = session.scope.split(' '); const scopeData: IScopeData = { scopes, scopeStr: session.scope, // filter our special scopes scopesToSend: scopes.filter(s => !s.startsWith('VSCODE_')).join(' '), clientId: this.getClientId(scopes), tenant: this.getTenantId(scopes), }; try { await this.refreshToken(session.refreshToken, scopeData, session.id); } catch (e) { // If we aren't connected to the internet, then wait and try to refresh again later. if (e.message === REFRESH_NETWORK_FAILURE) { this._tokens.push({ accessToken: undefined, refreshToken: session.refreshToken, account: { ...session.account, type: MicrosoftAccountType.Unknown }, scope: session.scope, sessionId: session.id }); } else { vscode.window.showErrorMessage(vscode.l10n.t('You have been signed out because reading stored authentication information failed.')); this._logger.error(e); await this.removeSessionByIToken({ accessToken: undefined, refreshToken: session.refreshToken, account: { ...session.account, type: MicrosoftAccountType.Unknown }, scope: session.scope, sessionId: session.id }); } } }); const result = await Promise.allSettled(refreshes); for (const res of result) { if (res.status === 'rejected') { this._logger.error(`Failed to initialize stored data: ${res.reason}`); this.clearSessions(); break; } } for (const token of this._tokens) { /* __GDPR__ "login" : { "owner": "TylerLeonhardt", "comment": "Used to determine the usage of the Microsoft Auth Provider.", "scopes": { "classification": "PublicNonPersonalData", "purpose": "FeatureInsight", "comment": "Used to determine what scope combinations are being requested." }, "accountType": { "classification": "PublicNonPersonalData", "purpose": "FeatureInsight", "comment": "Used to determine what account types are being used." } } */ this._telemetryReporter.sendTelemetryEvent('account', { // Get rid of guids from telemetry. scopes: JSON.stringify(token.scope.replace(/[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}/i, '{guid}').split(' ')), accountType: token.account.type }); } } //#region session operations public get onDidChangeSessions(): vscode.Event { return this._sessionChangeEmitter.event; } async getSessions(scopes?: string[]): Promise { if (!scopes) { this._logger.info('Getting sessions for all scopes...'); const sessions = this._tokens.map(token => this.convertToSessionSync(token)); this._logger.info(`Got ${sessions.length} sessions for all scopes...`); return sessions; } let modifiedScopes = [...scopes]; if (!modifiedScopes.includes('openid')) { modifiedScopes.push('openid'); } if (!modifiedScopes.includes('email')) { modifiedScopes.push('email'); } if (!modifiedScopes.includes('profile')) { modifiedScopes.push('profile'); } if (!modifiedScopes.includes('offline_access')) { modifiedScopes.push('offline_access'); } modifiedScopes = modifiedScopes.sort(); let modifiedScopesStr = modifiedScopes.join(' '); this._logger.info(`Getting sessions for the following scopes: ${modifiedScopesStr}`); if (this._refreshingPromise) { this._logger.info('Refreshing in progress. Waiting for completion before continuing.'); try { await this._refreshingPromise; } catch (e) { // this will get logged in the refresh function. } } let matchingTokens = this._tokens.filter(token => token.scope === modifiedScopesStr); // The user may still have a token that doesn't have the openid & email scopes so check for that as well. // Eventually, we should remove this and force the user to re-log in so that we don't have any sessions // without an idtoken. if (!matchingTokens.length) { const fallbackOrderedScopes = scopes.sort().join(' '); this._logger.trace(`No session found with idtoken scopes... Using fallback scope list of: ${fallbackOrderedScopes}`); matchingTokens = this._tokens.filter(token => token.scope === fallbackOrderedScopes); if (matchingTokens.length) { modifiedScopesStr = fallbackOrderedScopes; } } const clientId = this.getClientId(scopes); const scopeData: IScopeData = { clientId, originalScopes: scopes, scopes: modifiedScopes, scopeStr: modifiedScopesStr, // filter our special scopes scopesToSend: modifiedScopes.filter(s => !s.startsWith('VSCODE_')).join(' '), tenant: this.getTenantId(scopes), }; // If we still don't have a matching token try to get a new token from an existing token by using // the refreshToken. This is documented here: // https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth2-auth-code-flow#refresh-the-access-token // "Refresh tokens are valid for all permissions that your client has already received consent for." if (!matchingTokens.length) { // Get a token with the correct client id. const token = clientId === DEFAULT_CLIENT_ID ? this._tokens.find(t => t.refreshToken && !t.scope.includes('VSCODE_CLIENT_ID')) : this._tokens.find(t => t.refreshToken && t.scope.includes(`VSCODE_CLIENT_ID:${clientId}`)); if (token) { try { const itoken = await this.refreshToken(token.refreshToken, scopeData); matchingTokens.push(itoken); } catch (err) { this._logger.error(`Attempted to get a new session for scopes '${scopeData.scopeStr}' using the existing session with scopes '${token.scope}' but it failed due to: ${err.message ?? err}`); } } } this._logger.info(`Got ${matchingTokens.length} sessions for scopes: ${modifiedScopesStr}`); return Promise.all(matchingTokens.map(token => this.convertToSession(token, scopeData))); } public async createSession(scopes: string[]): Promise { let modifiedScopes = [...scopes]; if (!modifiedScopes.includes('openid')) { modifiedScopes.push('openid'); } if (!modifiedScopes.includes('email')) { modifiedScopes.push('email'); } if (!modifiedScopes.includes('profile')) { modifiedScopes.push('profile'); } if (!modifiedScopes.includes('offline_access')) { modifiedScopes.push('offline_access'); } modifiedScopes = modifiedScopes.sort(); const scopeData: IScopeData = { originalScopes: scopes, scopes: modifiedScopes, scopeStr: modifiedScopes.join(' '), // filter our special scopes scopesToSend: modifiedScopes.filter(s => !s.startsWith('VSCODE_')).join(' '), clientId: this.getClientId(scopes), tenant: this.getTenantId(scopes), }; this._logger.info(`Logging in for the following scopes: ${scopeData.scopeStr}`); const runsRemote = vscode.env.remoteName !== undefined; const runsServerless = vscode.env.remoteName === undefined && vscode.env.uiKind === vscode.UIKind.Web; if (runsServerless && this._loginEndpointUrl !== defaultLoginEndpointUrl) { throw new Error('Sign in to non-public clouds is not supported on the web.'); } if (runsRemote || runsServerless) { return this.createSessionWithoutLocalServer(scopeData); } try { const session = await this.createSessionWithLocalServer(scopeData); this._sessionChangeEmitter.fire({ added: [session], removed: [], changed: [] }); return session; } catch (e) { this._logger.error(`Error creating session for scopes: ${scopeData.scopeStr} Error: ${e}`); // If the error was about starting the server, try directly hitting the login endpoint instead if (e.message === 'Error listening to server' || e.message === 'Closed' || e.message === 'Timeout waiting for port') { return this.createSessionWithoutLocalServer(scopeData); } throw e; } } private async createSessionWithLocalServer(scopeData: IScopeData) { const codeVerifier = generateCodeVerifier(); const codeChallenge = await generateCodeChallenge(codeVerifier); const qs = new URLSearchParams({ response_type: 'code', response_mode: 'query', client_id: scopeData.clientId, redirect_uri: redirectUrl, scope: scopeData.scopesToSend, prompt: 'select_account', code_challenge_method: 'S256', code_challenge: codeChallenge, }).toString(); const loginUrl = `${this._loginEndpointUrl}${scopeData.tenant}/oauth2/v2.0/authorize?${qs}`; const server = new LoopbackAuthServer(path.join(__dirname, '../media'), loginUrl); await server.start(); let codeToExchange; try { vscode.env.openExternal(vscode.Uri.parse(`http://127.0.0.1:${server.port}/signin?nonce=${encodeURIComponent(server.nonce)}`)); const { code } = await server.waitForOAuthResponse(); codeToExchange = code; } finally { setTimeout(() => { void server.stop(); }, 5000); } const session = await this.exchangeCodeForSession(codeToExchange, codeVerifier, scopeData); return session; } private async createSessionWithoutLocalServer(scopeData: IScopeData): Promise { let callbackUri = await vscode.env.asExternalUri(vscode.Uri.parse(`${vscode.env.uriScheme}://vscode.microsoft-authentication`)); const nonce = generateCodeVerifier(); const callbackQuery = new URLSearchParams(callbackUri.query); callbackQuery.set('nonce', encodeURIComponent(nonce)); callbackUri = callbackUri.with({ query: callbackQuery.toString() }); const state = encodeURIComponent(callbackUri.toString(true)); const codeVerifier = generateCodeVerifier(); const codeChallenge = await generateCodeChallenge(codeVerifier); const signInUrl = `${this._loginEndpointUrl}${scopeData.tenant}/oauth2/v2.0/authorize`; const oauthStartQuery = new URLSearchParams({ response_type: 'code', client_id: encodeURIComponent(scopeData.clientId), response_mode: 'query', redirect_uri: redirectUrl, state, scope: scopeData.scopesToSend, prompt: 'select_account', code_challenge_method: 'S256', code_challenge: codeChallenge, }); const uri = vscode.Uri.parse(`${signInUrl}?${oauthStartQuery.toString()}`); vscode.env.openExternal(uri); let inputBox: vscode.InputBox | undefined; const timeoutPromise = new Promise((_: (value: vscode.AuthenticationSession) => void, reject) => { const wait = setTimeout(() => { clearTimeout(wait); inputBox?.dispose(); reject('Login timed out.'); }, 1000 * 60 * 5); }); const existingNonces = this._pendingNonces.get(scopeData.scopeStr) || []; this._pendingNonces.set(scopeData.scopeStr, [...existingNonces, nonce]); // Register a single listener for the URI callback, in case the user starts the login process multiple times // before completing it. let existingPromise = this._codeExchangePromises.get(scopeData.scopeStr); if (!existingPromise) { if (isSupportedEnvironment(callbackUri)) { existingPromise = this.handleCodeResponse(scopeData); } else { inputBox = vscode.window.createInputBox(); existingPromise = this.handleCodeInputBox(inputBox, codeVerifier, scopeData); } this._codeExchangePromises.set(scopeData.scopeStr, existingPromise); } this._codeVerfifiers.set(nonce, codeVerifier); return Promise.race([existingPromise, timeoutPromise]) .finally(() => { this._pendingNonces.delete(scopeData.scopeStr); this._codeExchangePromises.delete(scopeData.scopeStr); this._codeVerfifiers.delete(nonce); }); } public async removeSessionById(sessionId: string, writeToDisk: boolean = true): Promise { this._logger.info(`Logging out of session '${sessionId}'`); const tokenIndex = this._tokens.findIndex(token => token.sessionId === sessionId); if (tokenIndex === -1) { this._logger.info(`Session not found '${sessionId}'`); return Promise.resolve(undefined); } const token = this._tokens.splice(tokenIndex, 1)[0]; const session = await this.removeSessionByIToken(token, writeToDisk); if (session) { this._sessionChangeEmitter.fire({ added: [], removed: [session], changed: [] }); } return session; } public async clearSessions() { this._logger.info('Logging out of all sessions'); this._tokens = []; await this._tokenStorage.deleteAll(item => this.sessionMatchesEndpoint(item)); this._refreshTimeouts.forEach(timeout => { clearTimeout(timeout); }); this._refreshTimeouts.clear(); } private async removeSessionByIToken(token: IToken, writeToDisk: boolean = true): Promise { this.removeSessionTimeout(token.sessionId); if (writeToDisk) { await this._tokenStorage.delete(token.sessionId); } const tokenIndex = this._tokens.findIndex(t => t.sessionId === token.sessionId); if (tokenIndex !== -1) { this._tokens.splice(tokenIndex, 1); } const session = this.convertToSessionSync(token); this._logger.info(`Sending change event for session that was removed with scopes: ${token.scope}`); this._sessionChangeEmitter.fire({ added: [], removed: [session], changed: [] }); this._logger.info(`Logged out of session '${token.sessionId}' with scopes: ${token.scope}`); return session; } //#endregion //#region timeout private setSessionTimeout(sessionId: string, refreshToken: string, scopeData: IScopeData, timeout: number) { this.removeSessionTimeout(sessionId); this._refreshTimeouts.set(sessionId, setTimeout(async () => { try { const refreshedToken = await this.refreshToken(refreshToken, scopeData, sessionId); this._logger.info('Triggering change session event...'); this._sessionChangeEmitter.fire({ added: [], removed: [], changed: [this.convertToSessionSync(refreshedToken)] }); } catch (e) { if (e.message !== REFRESH_NETWORK_FAILURE) { vscode.window.showErrorMessage(vscode.l10n.t('You have been signed out because reading stored authentication information failed.')); await this.removeSessionById(sessionId); } } }, timeout)); } private removeSessionTimeout(sessionId: string): void { const timeout = this._refreshTimeouts.get(sessionId); if (timeout) { clearTimeout(timeout); this._refreshTimeouts.delete(sessionId); } } //#endregion //#region convert operations private convertToTokenSync(json: ITokenResponse, scopeData: IScopeData, existingId?: string): IToken { let claims = undefined; try { if (json.id_token) { claims = JSON.parse(base64Decode(json.id_token.split('.')[1])); } else { this._logger.info('Attempting to parse access_token instead since no id_token was included in the response.'); claims = JSON.parse(base64Decode(json.access_token.split('.')[1])); } } catch (e) { throw e; } let label; if (claims.name && claims.email) { label = `${claims.name} - ${claims.email}`; } else { label = claims.email ?? claims.unique_name ?? claims.preferred_username ?? 'user@example.com'; } const id = `${claims.tid}/${(claims.oid ?? (claims.altsecid ?? '' + claims.ipd ?? ''))}`; return { expiresIn: json.expires_in, expiresAt: json.expires_in ? Date.now() + json.expires_in * 1000 : undefined, accessToken: json.access_token, idToken: json.id_token, refreshToken: json.refresh_token, scope: scopeData.scopeStr, sessionId: existingId || `${id}/${randomUUID()}`, account: { label, id, type: claims.tid === MSA_TID || claims.tid === MSA_PASSTHRU_TID ? MicrosoftAccountType.MSA : MicrosoftAccountType.AAD } }; } /** * Return a session object without checking for expiry and potentially refreshing. * @param token The token information. */ private convertToSessionSync(token: IToken): vscode.AuthenticationSession { return { id: token.sessionId, accessToken: token.accessToken!, idToken: token.idToken, account: token.account, scopes: token.scope.split(' ') }; } private async convertToSession(token: IToken, scopeData: IScopeData): Promise { if (token.accessToken && (!token.expiresAt || token.expiresAt > Date.now())) { token.expiresAt ? this._logger.info(`Token available from cache (for scopes ${token.scope}), expires in ${token.expiresAt - Date.now()} milliseconds`) : this._logger.info('Token available from cache (for scopes ${token.scope})'); return { id: token.sessionId, accessToken: token.accessToken, idToken: token.idToken, account: token.account, scopes: scopeData.originalScopes ?? scopeData.scopes }; } try { this._logger.info(`Token expired or unavailable (for scopes ${token.scope}), trying refresh`); const refreshedToken = await this.refreshToken(token.refreshToken, scopeData, token.sessionId); if (refreshedToken.accessToken) { return { id: token.sessionId, accessToken: refreshedToken.accessToken, idToken: refreshedToken.idToken, account: token.account, // We always prefer the original scopes requested since that array is used as a key in the AuthService scopes: scopeData.originalScopes ?? scopeData.scopes }; } else { throw new Error(); } } catch (e) { throw new Error('Unavailable due to network problems'); } } //#endregion //#region refresh logic private async refreshToken(refreshToken: string, scopeData: IScopeData, sessionId?: string): Promise { this._refreshingPromise = this.doRefreshToken(refreshToken, scopeData, sessionId); try { const result = await this._refreshingPromise; return result; } finally { this._refreshingPromise = undefined; } } private async doRefreshToken(refreshToken: string, scopeData: IScopeData, sessionId?: string): Promise { this._logger.info(`Refreshing token for scopes: ${scopeData.scopeStr}`); const postData = querystring.stringify({ refresh_token: refreshToken, client_id: scopeData.clientId, grant_type: 'refresh_token', scope: scopeData.scopesToSend }); const proxyEndpoints: { [providerId: string]: string } | undefined = await vscode.commands.executeCommand('workbench.getCodeExchangeProxyEndpoints'); const endpointUrl = proxyEndpoints?.microsoft || this._loginEndpointUrl; const endpoint = `${endpointUrl}${scopeData.tenant}/oauth2/v2.0/token`; try { const json = await this.fetchTokenResponse(endpoint, postData, scopeData); const token = this.convertToTokenSync(json, scopeData, sessionId); if (token.expiresIn) { this.setSessionTimeout(token.sessionId, token.refreshToken, scopeData, token.expiresIn * AzureActiveDirectoryService.REFRESH_TIMEOUT_MODIFIER); } this.setToken(token, scopeData); this._logger.info(`Token refresh success for scopes: ${token.scope}`); return token; } catch (e) { if (e.message === REFRESH_NETWORK_FAILURE) { // We were unable to refresh because of a network failure (i.e. the user lost internet access). // so set up a timeout to try again later. We only do this if we have a session id to reference later. if (sessionId) { this.setSessionTimeout(sessionId, refreshToken, scopeData, AzureActiveDirectoryService.POLLING_CONSTANT); } throw e; } this._logger.error(`Refreshing token failed (for scopes: ${scopeData.scopeStr}): ${e.message}`); throw e; } } //#endregion //#region scope parsers private getClientId(scopes: string[]) { return scopes.reduce((prev, current) => { if (current.startsWith('VSCODE_CLIENT_ID:')) { return current.split('VSCODE_CLIENT_ID:')[1]; } return prev; }, undefined) ?? DEFAULT_CLIENT_ID; } private getTenantId(scopes: string[]) { return scopes.reduce((prev, current) => { if (current.startsWith('VSCODE_TENANT:')) { return current.split('VSCODE_TENANT:')[1]; } return prev; }, undefined) ?? DEFAULT_TENANT; } //#endregion //#region oauth flow private async handleCodeResponse(scopeData: IScopeData): Promise { let uriEventListener: vscode.Disposable; return new Promise((resolve: (value: vscode.AuthenticationSession) => void, reject) => { uriEventListener = this._uriHandler.event(async (uri: vscode.Uri) => { try { const query = querystring.parse(uri.query); let { code, nonce } = query; if (Array.isArray(code)) { code = code[0]; } if (!code) { throw new Error('No code included in query'); } if (Array.isArray(nonce)) { nonce = nonce[0]; } if (!nonce) { throw new Error('No nonce included in query'); } const acceptedStates = this._pendingNonces.get(scopeData.scopeStr) || []; // Workaround double encoding issues of state in web if (!acceptedStates.includes(nonce) && !acceptedStates.includes(decodeURIComponent(nonce))) { throw new Error('Nonce does not match.'); } const verifier = this._codeVerfifiers.get(nonce) ?? this._codeVerfifiers.get(decodeURIComponent(nonce)); if (!verifier) { throw new Error('No available code verifier'); } const session = await this.exchangeCodeForSession(code, verifier, scopeData); resolve(session); } catch (err) { reject(err); } }); }).then(result => { uriEventListener.dispose(); return result; }).catch(err => { uriEventListener.dispose(); throw err; }); } private async handleCodeInputBox(inputBox: vscode.InputBox, verifier: string, scopeData: IScopeData): Promise { inputBox.ignoreFocusOut = true; inputBox.title = vscode.l10n.t('Microsoft Authentication'); inputBox.prompt = vscode.l10n.t('Provide the authorization code to complete the sign in flow.'); inputBox.placeholder = vscode.l10n.t('Paste authorization code here...'); return new Promise((resolve: (value: vscode.AuthenticationSession) => void, reject) => { inputBox.show(); inputBox.onDidAccept(async () => { const code = inputBox.value; if (code) { inputBox.dispose(); const session = await this.exchangeCodeForSession(code, verifier, scopeData); resolve(session); } }); inputBox.onDidHide(() => { if (!inputBox.value) { inputBox.dispose(); reject('Cancelled'); } }); }); } private async exchangeCodeForSession(code: string, codeVerifier: string, scopeData: IScopeData): Promise { this._logger.info(`Exchanging login code for token for scopes: ${scopeData.scopeStr}`); let token: IToken | undefined; try { const postData = querystring.stringify({ grant_type: 'authorization_code', code: code, client_id: scopeData.clientId, scope: scopeData.scopesToSend, code_verifier: codeVerifier, redirect_uri: redirectUrl }); let endpointUrl: string; if (this._loginEndpointUrl !== defaultLoginEndpointUrl) { // If this is for sovereign clouds, don't try using the proxy endpoint, which supports only public cloud endpointUrl = this._loginEndpointUrl; } else { const proxyEndpoints: { [providerId: string]: string } | undefined = await vscode.commands.executeCommand('workbench.getCodeExchangeProxyEndpoints'); endpointUrl = proxyEndpoints?.microsoft || this._loginEndpointUrl; } const endpoint = `${endpointUrl}${scopeData.tenant}/oauth2/v2.0/token`; const json = await this.fetchTokenResponse(endpoint, postData, scopeData); this._logger.info(`Exchanging login code for token (for scopes: ${scopeData.scopeStr}) succeeded!`); token = this.convertToTokenSync(json, scopeData); } catch (e) { this._logger.error(`Error exchanging code for token (for scopes ${scopeData.scopeStr}): ${e}`); throw e; } if (token.expiresIn) { this.setSessionTimeout(token.sessionId, token.refreshToken, scopeData, token.expiresIn * AzureActiveDirectoryService.REFRESH_TIMEOUT_MODIFIER); } this.setToken(token, scopeData); this._logger.info(`Login successful for scopes: ${scopeData.scopeStr}`); return await this.convertToSession(token, scopeData); } private async fetchTokenResponse(endpoint: string, postData: string, scopeData: IScopeData): Promise { let attempts = 0; while (attempts <= 3) { attempts++; let result; let errorMessage: string | undefined; try { result = await fetching(endpoint, { method: 'POST', headers: { 'Content-Type': 'application/x-www-form-urlencoded', 'Content-Length': postData.length.toString() }, body: postData }); } catch (e) { errorMessage = e.message ?? e; } if (!result || result.status > 499) { if (attempts > 3) { this._logger.error(`Fetching token failed for scopes (${scopeData.scopeStr}): ${result ? await result.text() : errorMessage}`); break; } // Exponential backoff await new Promise(resolve => setTimeout(resolve, 5 * attempts * attempts * 1000)); continue; } else if (!result.ok) { // For 4XX errors, the user may actually have an expired token or have changed // their password recently which is throwing a 4XX. For this, we throw an error // so that the user can be prompted to sign in again. throw new Error(await result.text()); } return await result.json() as ITokenResponse; } throw new Error(REFRESH_NETWORK_FAILURE); } //#endregion //#region storage operations private setToken(token: IToken, scopeData: IScopeData): void { this._logger.info(`Setting token for scopes: ${scopeData.scopeStr}`); const existingTokenIndex = this._tokens.findIndex(t => t.sessionId === token.sessionId); if (existingTokenIndex > -1) { this._tokens.splice(existingTokenIndex, 1, token); } else { this._tokens.push(token); } // Don't await because setting the token is only useful for any new windows that open. this.storeToken(token, scopeData); } private async storeToken(token: IToken, scopeData: IScopeData): Promise { if (!vscode.window.state.focused) { const shouldStore = await new Promise((resolve, _) => { // To handle the case where the window is not focused for a long time. We want to store the token // at some point so that the next time they _do_ interact with VS Code, they don't have to sign in again. const timer = setTimeout( () => resolve(true), // 5 hours + random extra 0-30 seconds so that each window doesn't try to store at the same time (18000000) + Math.floor(Math.random() * 30000) ); const dispose = vscode.Disposable.from( vscode.window.onDidChangeWindowState(e => { if (e.focused) { resolve(true); dispose.dispose(); clearTimeout(timer); } }), this._tokenStorage.onDidChangeInOtherWindow(e => { if (e.updated.includes(token.sessionId)) { resolve(false); dispose.dispose(); clearTimeout(timer); } }) ); }); if (!shouldStore) { this._logger.info(`Not storing token for scopes ${scopeData.scopeStr} because it was added in another window`); return; } } await this._tokenStorage.store(token.sessionId, { id: token.sessionId, refreshToken: token.refreshToken, scope: token.scope, account: token.account, endpoint: this._loginEndpointUrl, }); this._logger.info(`Stored token for scopes: ${scopeData.scopeStr}`); } private async checkForUpdates(e: IDidChangeInOtherWindowEvent): Promise { for (const key of e.added) { const session = await this._tokenStorage.get(key); if (!session) { this._logger.error('session not found that was apparently just added'); return; } if (!this.sessionMatchesEndpoint(session)) { // If the session wasn't made for this login endpoint, ignore this update continue; } const matchesExisting = this._tokens.some(token => token.scope === session.scope && token.sessionId === session.id); if (!matchesExisting && session.refreshToken) { try { const scopes = session.scope.split(' '); const scopeData: IScopeData = { scopes, scopeStr: session.scope, // filter our special scopes scopesToSend: scopes.filter(s => !s.startsWith('VSCODE_')).join(' '), clientId: this.getClientId(scopes), tenant: this.getTenantId(scopes), }; this._logger.info(`Session added in another window with scopes: ${session.scope}`); const token = await this.refreshToken(session.refreshToken, scopeData, session.id); this._logger.info(`Sending change event for session that was added with scopes: ${scopeData.scopeStr}`); this._sessionChangeEmitter.fire({ added: [this.convertToSessionSync(token)], removed: [], changed: [] }); return; } catch (e) { // Network failures will automatically retry on next poll. if (e.message !== REFRESH_NETWORK_FAILURE) { vscode.window.showErrorMessage(vscode.l10n.t('You have been signed out because reading stored authentication information failed.')); await this.removeSessionById(session.id); } return; } } } for (const { value } of e.removed) { if (!this.sessionMatchesEndpoint(value)) { // If the session wasn't made for this login endpoint, ignore this update continue; } this._logger.info(`Session removed in another window with scopes: ${value.scope}`); await this.removeSessionById(value.id, false); } // NOTE: We don't need to handle changed sessions because all that really would give us is a new refresh token // because access tokens are not stored in Secret Storage due to their short lifespan. This new refresh token // is not useful in this window because we really only care about the lifetime of the _access_ token which we // are already managing (see usages of `setSessionTimeout`). } private sessionMatchesEndpoint(session: IStoredSession): boolean { // For older sessions with no endpoint set, it can be assumed to be the default endpoint session.endpoint ||= defaultLoginEndpointUrl; return session.endpoint === this._loginEndpointUrl; } //#endregion }