推荐用于 Web API 的 ADAL 令牌缓存?
Recommended ADAL token cache for Web API?
我正在构建一个 .NET 核心 Web API,它使用 AAD 进行保护,并使用 ADAL 调用下游 API 使用代表流…。类似于此 Azure 示例:
https://github.com/Azure-Samples/active-directory-dotnet-webapi-onbehalfof
在这种情况下应该使用的令牌缓存的最佳做法是什么?
默认缓存是否可以接受?
你应该没有缓存吗?
AuthenticationContext authContext = new
AuthenticationContext(authority, null)
如果你应该建立自己的
那么有没有好的参考实现可以使用?
您使用的正确令牌缓存是非常主观的,实际上取决于您的体系结构、性能要求等。
ADAL 使用的默认缓存是内存缓存,这意味着它可能不会在您的 API 收到的请求中持续存在。此外,ADAL.NET 使用的默认缓存是静态 class,这意味着对 API 的两个不同请求可能会选择相同的缓存对象,这通常是意想不到的,因为这两个请求是可能针对不同的用户。因此通常不建议使用默认的 ADAL 缓存 - 这实际上取决于您的 Web 服务器的工作方式。
相反,如果您可以管理性能损失,我们建议将 null
作为令牌缓存传递,或者最好实现您自己的令牌缓存。
如果您想实现自己的缓存,这将使您的应用不必在每个传入请求上都向 AAD(通过 ADAL)发出出站 HTTP 请求。使用 .NET entity framework 的示例 ADAL 缓存实现可用 here,并复制如下:
using Microsoft.IdentityModel.Clients.ActiveDirectory;
using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.Data.Entity;
using System.Linq;
using System.Web;
namespace TodoListWebApp.DAL
{
public class PerWebUserCache
{
[Key]
public int EntryId { get; set; }
public string webUserUniqueId { get; set; }
public byte[] cacheBits { get; set; }
public DateTime LastWrite { get; set; }
}
public class EFADALTokenCache: TokenCache
{
private TodoListWebAppContext db = new TodoListWebAppContext();
string User;
PerWebUserCache Cache;
// constructor
public EFADALTokenCache(string user)
{
// associate the cache to the current user of the web app
User = user;
this.AfterAccess = AfterAccessNotification;
this.BeforeAccess = BeforeAccessNotification;
this.BeforeWrite = BeforeWriteNotification;
// look up the entry in the DB
Cache = db.PerUserCacheList.FirstOrDefault(c => c.webUserUniqueId == User);
// place the entry in memory
this.Deserialize((Cache == null) ? null : Cache.cacheBits);
}
// clean up the DB
public override void Clear()
{
base.Clear();
foreach (var cacheEntry in db.PerUserCacheList)
db.PerUserCacheList.Remove(cacheEntry);
db.SaveChanges();
}
// Notification raised before ADAL accesses the cache.
// This is your chance to update the in-memory copy from the DB, if the in-memory version is stale
void BeforeAccessNotification(TokenCacheNotificationArgs args)
{
if (Cache == null)
{
// first time access
Cache = db.PerUserCacheList.FirstOrDefault(c => c.webUserUniqueId == User);
}
else
{ // retrieve last write from the DB
var status = from e in db.PerUserCacheList
where (e.webUserUniqueId == User)
select new
{
LastWrite = e.LastWrite
};
// if the in-memory copy is older than the persistent copy
if (status.First().LastWrite > Cache.LastWrite)
//// read from from storage, update in-memory copy
{
Cache = db.PerUserCacheList.FirstOrDefault(c => c.webUserUniqueId == User);
}
}
this.Deserialize((Cache == null) ? null : Cache.cacheBits);
}
// Notification raised after ADAL accessed the cache.
// If the HasStateChanged flag is set, ADAL changed the content of the cache
void AfterAccessNotification(TokenCacheNotificationArgs args)
{
// if state changed
if (this.HasStateChanged)
{
Cache = new PerWebUserCache
{
webUserUniqueId = User,
cacheBits = this.Serialize(),
LastWrite = DateTime.Now
};
//// update the DB and the lastwrite
db.Entry(Cache).State = Cache.EntryId == 0 ? EntityState.Added : EntityState.Modified;
db.SaveChanges();
this.HasStateChanged = false;
}
}
void BeforeWriteNotification(TokenCacheNotificationArgs args)
{
// if you want to ensure that no concurrent write take place, use this notification to place a lock on the entry
}
}
}
我正在构建一个 .NET 核心 Web API,它使用 AAD 进行保护,并使用 ADAL 调用下游 API 使用代表流…。类似于此 Azure 示例:
https://github.com/Azure-Samples/active-directory-dotnet-webapi-onbehalfof
在这种情况下应该使用的令牌缓存的最佳做法是什么?
默认缓存是否可以接受?
你应该没有缓存吗?
AuthenticationContext authContext = new AuthenticationContext(authority, null)
如果你应该建立自己的 那么有没有好的参考实现可以使用?
您使用的正确令牌缓存是非常主观的,实际上取决于您的体系结构、性能要求等。
ADAL 使用的默认缓存是内存缓存,这意味着它可能不会在您的 API 收到的请求中持续存在。此外,ADAL.NET 使用的默认缓存是静态 class,这意味着对 API 的两个不同请求可能会选择相同的缓存对象,这通常是意想不到的,因为这两个请求是可能针对不同的用户。因此通常不建议使用默认的 ADAL 缓存 - 这实际上取决于您的 Web 服务器的工作方式。
相反,如果您可以管理性能损失,我们建议将 null
作为令牌缓存传递,或者最好实现您自己的令牌缓存。
如果您想实现自己的缓存,这将使您的应用不必在每个传入请求上都向 AAD(通过 ADAL)发出出站 HTTP 请求。使用 .NET entity framework 的示例 ADAL 缓存实现可用 here,并复制如下:
using Microsoft.IdentityModel.Clients.ActiveDirectory;
using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.Data.Entity;
using System.Linq;
using System.Web;
namespace TodoListWebApp.DAL
{
public class PerWebUserCache
{
[Key]
public int EntryId { get; set; }
public string webUserUniqueId { get; set; }
public byte[] cacheBits { get; set; }
public DateTime LastWrite { get; set; }
}
public class EFADALTokenCache: TokenCache
{
private TodoListWebAppContext db = new TodoListWebAppContext();
string User;
PerWebUserCache Cache;
// constructor
public EFADALTokenCache(string user)
{
// associate the cache to the current user of the web app
User = user;
this.AfterAccess = AfterAccessNotification;
this.BeforeAccess = BeforeAccessNotification;
this.BeforeWrite = BeforeWriteNotification;
// look up the entry in the DB
Cache = db.PerUserCacheList.FirstOrDefault(c => c.webUserUniqueId == User);
// place the entry in memory
this.Deserialize((Cache == null) ? null : Cache.cacheBits);
}
// clean up the DB
public override void Clear()
{
base.Clear();
foreach (var cacheEntry in db.PerUserCacheList)
db.PerUserCacheList.Remove(cacheEntry);
db.SaveChanges();
}
// Notification raised before ADAL accesses the cache.
// This is your chance to update the in-memory copy from the DB, if the in-memory version is stale
void BeforeAccessNotification(TokenCacheNotificationArgs args)
{
if (Cache == null)
{
// first time access
Cache = db.PerUserCacheList.FirstOrDefault(c => c.webUserUniqueId == User);
}
else
{ // retrieve last write from the DB
var status = from e in db.PerUserCacheList
where (e.webUserUniqueId == User)
select new
{
LastWrite = e.LastWrite
};
// if the in-memory copy is older than the persistent copy
if (status.First().LastWrite > Cache.LastWrite)
//// read from from storage, update in-memory copy
{
Cache = db.PerUserCacheList.FirstOrDefault(c => c.webUserUniqueId == User);
}
}
this.Deserialize((Cache == null) ? null : Cache.cacheBits);
}
// Notification raised after ADAL accessed the cache.
// If the HasStateChanged flag is set, ADAL changed the content of the cache
void AfterAccessNotification(TokenCacheNotificationArgs args)
{
// if state changed
if (this.HasStateChanged)
{
Cache = new PerWebUserCache
{
webUserUniqueId = User,
cacheBits = this.Serialize(),
LastWrite = DateTime.Now
};
//// update the DB and the lastwrite
db.Entry(Cache).State = Cache.EntryId == 0 ? EntityState.Added : EntityState.Modified;
db.SaveChanges();
this.HasStateChanged = false;
}
}
void BeforeWriteNotification(TokenCacheNotificationArgs args)
{
// if you want to ensure that no concurrent write take place, use this notification to place a lock on the entry
}
}
}