Skip to content

Commit 608bdbd

Browse files
learn-build-service-prod[bot]openpublishbuildandrewconnell
authored
[Validation Auto Healing] [Merge by 2025-05-06] (SharePoint#10219)
* update * update timestamp & grammatical fixes --------- Co-authored-by: OpenPublishing.Build <[email protected]> Co-authored-by: Andrew Connell <[email protected]>
1 parent f85b49b commit 608bdbd

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

docs/sp-add-ins/handle-security-tokens-in-provider-hosted-low-trust-sharepoint-add-ins.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Handle security tokens in provider-hosted low-trust SharePoint Add-ins
33
description: The context, access, and refresh tokens that are used for authorization by low-trust, provider-hosted SharePoint Add-ins, and how to work with them in your code.
4-
ms.date: 09/26/2023
4+
ms.date: 05/01/2025
55
ms.localizationpriority: high
66
ms.service: sharepoint
77
---
@@ -24,7 +24,7 @@ There are different flows depending on the design of the add-in, but all of them
2424

2525
Depending on which OAuth flow the add-in is using, one or the other of the following is also part of the process:
2626

27-
- **Context token**. Used, in the Context Token flow, to provide the remote component with a refresh token and with information that it needs to request an access token from Azure ACS.
27+
- **Context token**. Used in the Context Token flow, to provide the remote component with a refresh token and with information that it needs to request an access token from Azure ACS.
2828
- **Authorization code**. Not a token, but an authorization code, unique to each pair of user and application. It's used in the Authorization Code flow to obtain a first access token and a refresh token.
2929

3030
## Access tokens
@@ -45,12 +45,12 @@ Depending on your SharePoint Add-in's architecture and the hosting platform, the
4545
- In session state
4646
- In application state
4747
- In [Windows Server AppFabric Caching](/previous-versions/appfabric/ff383731(v=azure.10)) or its equivalent in a non-Microsoft operating system
48-
- In the [Microsoft Azure Caching Service](/azure/redis-cache/cache-faq) or its equivalent in a non-Microsoft cloud service
48+
- In the [Microsoft Azure Caching Service](/azure/redis/faq) or its equivalent in a non-Microsoft cloud service
4949
- In a database
5050
- In a [memcached](http://www.memcached.org/) system
5151

5252
> [!NOTE]
53-
> In most scenarios, you won't be able to use terms as simple as "AccessToken" as the caching key because your add-in must keep the tokens for different users and SharePoint farms/tenancies distinct. If your add-in uses the [Context Token flow](context-token-oauth-flow-for-sharepoint-add-ins.md), there's special **CacheKey** provided by SharePoint that can be used to distinguish cached tokens. This section explains what the issues are and what to do when your application isn't using the Context Token flow.
53+
> In most scenarios, you won't be able to use terms as simple as "AccessToken" as the caching key because your add-in must keep the tokens for different users and SharePoint farms/tenancies distinct. If your add-in uses the [Context Token flow](context-token-oauth-flow-for-sharepoint-add-ins.md), there's a special **CacheKey** provided by SharePoint that can be used to distinguish cached tokens. This section explains what the issues are and what to do when your application isn't using the Context Token flow.
5454
5555
Caching the access token in **session state** is fine for most scenarios. If the remote web application is accessing other services that use OAuth (in addition to SharePoint) and its caching the various access tokens in session state, be sure to use distinct cache keys for the tokens; for example, instead of "AccessToken", use "SharePoint\_AccessToken", "Facebook\_AccessToken", "SAP\_Gateway\_AccessToken", and so on. (If you're not using session state or some other caching that automatically separates each user's cache, you need to relativize your keys for users.)
5656

0 commit comments

Comments
 (0)