Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Use tenant domain instead of siteUrl in /shares api in ODSP driver #20738

Merged
merged 5 commits into from
Apr 21, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
86 changes: 62 additions & 24 deletions packages/drivers/odsp-driver/src/fetchSnapshot.ts
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ import { ITelemetryLoggerExt } from "@fluidframework/telemetry-utils";
import {
PerformanceEvent,
isFluidError,
loggerToMonitoringContext,
wrapError,
} from "@fluidframework/telemetry-utils/internal";
import { v4 as uuid } from "uuid";
Expand Down Expand Up @@ -220,34 +221,71 @@ async function redeemSharingLink(
storageTokenFetcher: InstrumentedStorageTokenFetcher,
logger: ITelemetryLoggerExt,
forceAccessTokenViaAuthorizationHeader: boolean,
): Promise<IOdspResponse<unknown>> {
return PerformanceEvent.timedExecAsync(
): Promise<void> {
await PerformanceEvent.timedExecAsync(
logger,
{
eventName: "RedeemShareLink",
},
async () =>
getWithRetryForTokenRefresh(async (tokenFetchOptions) => {
assert(
!!odspResolvedUrl.shareLinkInfo?.sharingLinkToRedeem,
0x1ed /* "Share link should be present" */,
);
const storageToken = await storageTokenFetcher(
tokenFetchOptions,
"RedeemShareLink",
);
const encodedShareUrl = getEncodedShareUrl(
odspResolvedUrl.shareLinkInfo?.sharingLinkToRedeem,
);
const redeemUrl = `${odspResolvedUrl.siteUrl}/_api/v2.0/shares/${encodedShareUrl}`;
const { url, headers } = getUrlAndHeadersWithAuth(
redeemUrl,
storageToken,
forceAccessTokenViaAuthorizationHeader,
);
headers.prefer = "redeemSharingLink";
return fetchAndParseAsJSONHelper(url, { headers });
}),
async () => {
assert(
!!odspResolvedUrl.shareLinkInfo?.sharingLinkToRedeem,
0x1ed /* "Share link should be present" */,
);

const encodedShareUrl = getEncodedShareUrl(
odspResolvedUrl.shareLinkInfo?.sharingLinkToRedeem,
);

let redeemUrl: string | undefined;
async function callSharesAPI(baseUrl: string): Promise<void> {
await getWithRetryForTokenRefresh(async (tokenFetchOptions) => {
const storageToken = await storageTokenFetcher(
tokenFetchOptions,
"RedeemShareLink",
);
redeemUrl = `${baseUrl}/_api/v2.0/shares/${encodedShareUrl}`;
const { url, headers } = getUrlAndHeadersWithAuth(
redeemUrl,
storageToken,
forceAccessTokenViaAuthorizationHeader,
);
headers.prefer = "redeemSharingLink";
await fetchAndParseAsJSONHelper(url, { headers });
});
}

const disableUsingTenantDomain = loggerToMonitoringContext(logger).config.getBoolean(
"Fluid.Driver.Odsp.DisableUsingTenantDomainForSharesApi",
);
// There is an issue where if we use the siteUrl in /shares, then the allowed length of url is just a few hundred characters(300-400)
// and we fail to do the redeem. But if we use the tenant domain in the url, then the allowed length becomes 2048. So, first
// construct the url for /shares using tenant domain but to be on safer side, fallback to using the siteUrl. We get tenant domain
// by getting origin of the siteUrl.
if (!disableUsingTenantDomain) {
try {
await callSharesAPI(new URL(odspResolvedUrl.siteUrl).origin);
jatgarg marked this conversation as resolved.
Show resolved Hide resolved
return;
} catch (error) {
logger.sendTelemetryEvent(
{
eventName: "ShareLinkRedeemFailedWithTenantDomain",
details: JSON.stringify({
length: redeemUrl?.length,
jatgarg marked this conversation as resolved.
Show resolved Hide resolved
shareLinkUrlLength:
odspResolvedUrl.shareLinkInfo?.sharingLinkToRedeem.length,
queryParamsLength: new URL(
odspResolvedUrl.shareLinkInfo?.sharingLinkToRedeem,
).search.length,
useHeaders: forceAccessTokenViaAuthorizationHeader,
}),
},
error,
);
}
}
await callSharesAPI(odspResolvedUrl.siteUrl);
},
);
}

Expand Down
98 changes: 97 additions & 1 deletion packages/drivers/odsp-driver/src/test/fetchSnapshot.spec.ts
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,13 @@ import { OdspDriverUrlResolver } from "../odspDriverUrlResolver.js";
import { getHashedDocumentId } from "../odspPublicUtils.js";
import { INewFileInfo, IOdspResponse, createCacheSnapshotKey } from "../odspUtils.js";

import { createResponse } from "./mockFetch.js";
import {
createResponse,
mockFetchMultiple,
notFound,
okResponse,
type MockResponse,
} from "./mockFetch.js";

const createUtLocalCache = (): LocalPersistentCache => new LocalPersistentCache();

Expand Down Expand Up @@ -469,6 +475,96 @@ describe("Tests1 for snapshot fetch", () => {
"unexpected events",
);
});

it("RedeemFallback behavior when fallback succeeds with using tenant domain", async () => {
resolved.shareLinkInfo = {
sharingLinkToRedeem: "https://microsoft.sharepoint-df.com/sharelink",
};
hostPolicy.enableRedeemFallback = true;

const snapshot: ISnapshot = {
blobContents,
snapshotTree: snapshotTreeWithGroupId,
ops: [],
latestSequenceNumber: 0,
sequenceNumber: 0,
snapshotFormatV: 1,
};
const response = (await createResponse(
{ "x-fluid-epoch": "epoch1", "content-type": "application/ms-fluid" },
convertToCompactSnapshot(snapshot),
200,
)) as unknown as Response;

await assert.doesNotReject(
async () =>
mockFetchMultiple(
async () => service.getSnapshot({}),
[
notFound,
async (): Promise<MockResponse> => okResponse({}, {}),
jatgarg marked this conversation as resolved.
Show resolved Hide resolved
async (): Promise<Response> => {
return response;
},
],
),
"Should succeed",
);
assert(
mockLogger.matchEvents([
{ eventName: "TreesLatest_cancel", shareLinkPresent: true },
{ eventName: "RedeemShareLink_end" },
{ eventName: "RedeemFallback", errorType: "fileNotFoundOrAccessDeniedError" },
{ eventName: "TreesLatest_end" },
]),
);
});

it("RedeemFallback behavior when fallback succeeds with using siteUrl", async () => {
resolved.shareLinkInfo = {
sharingLinkToRedeem: "https://microsoft.sharepoint-df.com/sharelink",
};
hostPolicy.enableRedeemFallback = true;

const snapshot: ISnapshot = {
blobContents,
snapshotTree: snapshotTreeWithGroupId,
ops: [],
latestSequenceNumber: 0,
sequenceNumber: 0,
snapshotFormatV: 1,
};
const response = (await createResponse(
{ "x-fluid-epoch": "epoch1", "content-type": "application/ms-fluid" },
convertToCompactSnapshot(snapshot),
200,
)) as unknown as Response;

await assert.doesNotReject(
async () =>
mockFetchMultiple(
async () => service.getSnapshot({}),
[
notFound,
notFound,
jatgarg marked this conversation as resolved.
Show resolved Hide resolved
async (): Promise<MockResponse> => okResponse({}, {}),
async (): Promise<Response> => {
return response;
},
],
),
"Should succeed",
);
assert(
mockLogger.matchEvents([
{ eventName: "TreesLatest_cancel", shareLinkPresent: true },
{ eventName: "ShareLinkRedeemFailedWithTenantDomain", statusCode: 404 },
{ eventName: "RedeemShareLink_end" },
{ eventName: "RedeemFallback", errorType: "fileNotFoundOrAccessDeniedError" },
{ eventName: "TreesLatest_end" },
]),
);
});
});

const snapshotTreeWithGroupId: ISnapshotTree = {
Expand Down
Loading