Eventi
19 nov, 23 - 21 nov, 23
Partecipa alle sessioni online di Microsoft Ignite create per espandere le tue competenze e aiutarti a risolvere i problemi complessi di oggi.
Iscriviti subitoQuesto browser non è più supportato.
Esegui l'aggiornamento a Microsoft Edge per sfruttare i vantaggi di funzionalità più recenti, aggiornamenti della sicurezza e supporto tecnico.
Quando viene creato, identity è possibile assegnare una o più attestazioni rilasciate da una parte attendibile. Un'attestazione è una coppia di valori nome che rappresenta ciò che l'oggetto è, non le operazioni che l'oggetto può eseguire. Ad esempio, potresti avere una patente di guida, rilasciata da un'autorità di patente di guida locale. La patente del conducente ha la data di nascita. In questo caso il nome dell'attestazione sarà DateOfBirth
, il valore dell'attestazione sarà la data di nascita, ad esempio 8th June 1970
e l'autorità emittente sarebbe l'autorità di patente di guida. L'autorizzazione basata sulle attestazioni, al suo più semplice, controlla il valore di un'attestazione e consente l'accesso a una risorsa in base a tale valore. Ad esempio, se si vuole accedere a un night club, il processo di autorizzazione potrebbe essere:
Il responsabile della sicurezza delle porte valuterà il valore della data di nascita e se considerano attendibile l'autorità di certificazione (autorità di patente di guida) prima di concedere l'accesso.
Un identity può contenere più attestazioni con più valori e può contenere più attestazioni dello stesso tipo.
Controlli di autorizzazione basati su attestazioni:
Le attestazioni nel codice specificano le attestazioni che l'utente corrente deve possedere e, facoltativamente, il valore che l'attestazione deve contenere per accedere alla risorsa richiesta. I requisiti delle attestazioni sono basati su criteri; lo sviluppatore deve compilare e registrare un criterio che esprime i requisiti delle attestazioni.
Il tipo più semplice di criteri attestazione cerca la presenza di un'attestazione e non controlla il valore.
Compilare e registrare i criteri e chiamare UseAuthorization. La registrazione dei criteri avviene come parte della configurazione del servizio di autorizzazione, in genere nel Program.cs
file :
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddRazorPages();
builder.Services.AddControllersWithViews();
builder.Services.AddAuthorization(options =>
{
options.AddPolicy("EmployeeOnly", policy => policy.RequireClaim("EmployeeNumber"));
});
var app = builder.Build();
if (!app.Environment.IsDevelopment())
{
app.UseExceptionHandler("/Error");
app.UseHsts();
}
app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseAuthentication();
app.UseAuthorization();
app.MapDefaultControllerRoute();
app.MapRazorPages();
app.Run();
In questo caso, i criteri controllano EmployeeOnly
la presenza di un'attestazione EmployeeNumber
nell'oggetto corrente identity.
Applicare il criterio usando la Policy
proprietà sull'attributo [Authorize]
per specificare il nome del criterio.
[Authorize(Policy = "EmployeeOnly")]
public IActionResult VacationBalance()
{
return View();
}
L'attributo [Authorize]
può essere applicato a un intero controller o a un intero controller o Razor a una pagina, nel qual caso solo le identità che corrispondono ai criteri sono autorizzati ad accedere a qualsiasi azione nel controller.
[Authorize(Policy = "EmployeeOnly")]
public class VacationController : Controller
{
public IActionResult Index()
{
return View();
}
public ActionResult VacationBalance()
{
return View();
}
[AllowAnonymous]
public ActionResult VacationPolicy()
{
return View();
}
}
Il codice seguente applica l'attributo [Authorize]
a una Razor pagina:
[Authorize(Policy = "EmployeeOnly")]
public class IndexModel : PageModel
{
public void OnGet()
{
}
}
I criteri non possono essere applicati a livello di Razor gestore pagina, ma devono essere applicati alla pagina.
Se si dispone di un controller protetto dall'attributo ma si vuole consentire l'accesso [Authorize]
anonimo a determinate azioni, si applica l'attributo AllowAnonymousAttribute
.
[Authorize(Policy = "EmployeeOnly")]
public class VacationController : Controller
{
public IActionResult Index()
{
return View();
}
public ActionResult VacationBalance()
{
return View();
}
[AllowAnonymous]
public ActionResult VacationPolicy()
{
return View();
}
}
Poiché i criteri non possono essere applicati a livello di Razor gestore pagina, è consigliabile usare un controller quando i criteri devono essere applicati a livello di gestore di pagina. L'oggetto rest dell'app che non richiede criteri a livello di Razor gestore pagina può usare Razor Pages.
La maggior parte delle attestazioni è dotata di un valore. È possibile specificare un elenco di valori consentiti durante la creazione dei criteri. L'esempio seguente ha esito positivo solo per i dipendenti il cui numero di dipendente è 1, 2, 3, 4 o 5.
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddRazorPages();
builder.Services.AddControllersWithViews();
builder.Services.AddAuthorization(options =>
{
options.AddPolicy("Founders", policy =>
policy.RequireClaim("EmployeeNumber", "1", "2", "3", "4", "5"));
});
var app = builder.Build();
if (!app.Environment.IsDevelopment())
{
app.UseExceptionHandler("/Error");
app.UseHsts();
}
app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseAuthentication();
app.UseAuthorization();
app.MapDefaultControllerRoute();
app.MapRazorPages();
app.Run();
Se il valore dell'attestazione non è un singolo valore o è necessaria una trasformazione, usare RequireAssertion. Per altre informazioni, vedere Usare un func per soddisfare un criterio.
Se vengono applicati più criteri a livello di controller e azione, tutti i criteri devono superare prima che venga concesso l'accesso:
[Authorize(Policy = "EmployeeOnly")]
public class SalaryController : Controller
{
public IActionResult Index()
{
return View();
}
public IActionResult Payslip()
{
return View();
}
[Authorize(Policy = "HumanResources")]
public IActionResult UpdateSalary()
{
return View();
}
}
Nell'esempio precedente qualsiasi identity che soddisfi i EmployeeOnly
criteri può accedere all'azione Payslip
in quanto tale criterio viene applicato al controller. Tuttavia, per chiamare l'azione UpdateSalary
deve identity soddisfare sia i EmployeeOnly
criteri che i HumanResources
criteri.
Se si vogliono criteri più complessi, ad esempio l'assunzione di una data di nascita, il calcolo di un'età da esso e quindi il controllo che l'età è 21 o più recente, è necessario scrivere gestori di criteri personalizzati.
Nell'esempio seguente entrambi i metodi del gestore di pagine devono soddisfare sia i EmployeeOnly
criteri che i HumanResources
criteri:
[Authorize(Policy = "EmployeeOnly")]
[Authorize(Policy = "HumanResources")]
public class SalaryModel : PageModel
{
public ContentResult OnGetPayStub()
{
return Content("OnGetPayStub");
}
public ContentResult OnGetSalary()
{
return Content("OnGetSalary");
}
}
Quando viene creato, identity è possibile assegnare una o più attestazioni rilasciate da una parte attendibile. Un'attestazione è una coppia di valori nome che rappresenta ciò che l'oggetto è, non le operazioni che l'oggetto può eseguire. Ad esempio, potresti avere una patente di guida, rilasciata da un'autorità di patente di guida locale. La patente del conducente ha la data di nascita. In questo caso il nome dell'attestazione sarà DateOfBirth
, il valore dell'attestazione sarà la data di nascita, ad esempio 8th June 1970
e l'autorità emittente sarebbe l'autorità di patente di guida. L'autorizzazione basata sulle attestazioni, al suo più semplice, controlla il valore di un'attestazione e consente l'accesso a una risorsa in base a tale valore. Ad esempio, se si vuole accedere a un night club, il processo di autorizzazione potrebbe essere:
Il responsabile della sicurezza delle porte valuterà il valore della data di nascita e se considerano attendibile l'autorità di certificazione (autorità di patente di guida) prima di concedere l'accesso.
Un identity può contenere più attestazioni con più valori e può contenere più attestazioni dello stesso tipo.
I controlli di autorizzazione basati sulle attestazioni sono dichiarativi: gli sviluppatori li incorporano all'interno del codice, in un controller o in un'azione all'interno di un controller, specificando le attestazioni che l'utente corrente deve possedere e, facoltativamente, il valore che l'attestazione deve contenere per accedere alla risorsa richiesta. I requisiti delle attestazioni sono basati su criteri, lo sviluppatore deve compilare e registrare un criterio che esprime i requisiti delle attestazioni.
Il tipo più semplice di criteri attestazione cerca la presenza di un'attestazione e non controlla il valore.
Compilare e registrare i criteri. Questa operazione viene eseguita come parte della configurazione del servizio di autorizzazione, che in genere fa parte del ConfigureServices()
Startup.cs
file.
public void ConfigureServices(IServiceCollection services)
{
services.AddControllersWithViews();
services.AddRazorPages();
services.AddAuthorization(options =>
{
options.AddPolicy("EmployeeOnly", policy => policy.RequireClaim("EmployeeNumber"));
});
}
Chiamare UseAuthorization in Configure
. Il codice seguente viene generato dai modelli di app Web core di ASP.NET:
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
app.UseMigrationsEndPoint();
}
else
{
app.UseExceptionHandler("/Error");
app.UseHsts();
}
app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseRouting();
app.UseAuthentication();
app.UseAuthorization();
app.UseEndpoints(endpoints =>
{
endpoints.MapRazorPages();
});
}
In questo caso, i criteri controllano EmployeeOnly
la presenza di un'attestazione EmployeeNumber
nell'oggetto corrente identity.
Applicare quindi il criterio usando la Policy
proprietà sull'attributo [Authorize]
per specificare il nome del criterio;
[Authorize(Policy = "EmployeeOnly")]
public IActionResult VacationBalance()
{
return View();
}
L'attributo [Authorize]
può essere applicato a un intero controller, in questa istanza solo le identità corrispondenti ai criteri potranno accedere a qualsiasi azione nel controller.
[Authorize(Policy = "EmployeeOnly")]
public class VacationController : Controller
{
public ActionResult VacationBalance()
{
}
}
Se si dispone di un controller protetto dall'attributo , ma si vuole consentire l'accesso [Authorize]
anonimo a determinate azioni applicate all'attributo AllowAnonymousAttribute
.
[Authorize(Policy = "EmployeeOnly")]
public class VacationController : Controller
{
public ActionResult VacationBalance()
{
}
[AllowAnonymous]
public ActionResult VacationPolicy()
{
}
}
La maggior parte delle attestazioni è dotata di un valore. È possibile specificare un elenco di valori consentiti durante la creazione dei criteri. L'esempio seguente ha esito positivo solo per i dipendenti il cui numero di dipendente è 1, 2, 3, 4 o 5.
public void ConfigureServices(IServiceCollection services)
{
services.AddControllersWithViews();
services.AddRazorPages();
services.AddAuthorization(options =>
{
options.AddPolicy("Founders", policy =>
policy.RequireClaim("EmployeeNumber", "1", "2", "3", "4", "5"));
});
}
Se il valore dell'attestazione non è un singolo valore o è necessaria una trasformazione, usare RequireAssertion. Per altre informazioni, vedere Usare un func per soddisfare un criterio.
Se si applicano più criteri a un controller o a un'azione, tutti i criteri devono essere passati prima che venga concesso l'accesso. Ad esempio:
[Authorize(Policy = "EmployeeOnly")]
public class SalaryController : Controller
{
public ActionResult Payslip()
{
}
[Authorize(Policy = "HumanResources")]
public ActionResult UpdateSalary()
{
}
}
Nell'esempio precedente qualsiasi identity che soddisfi i EmployeeOnly
criteri può accedere all'azione Payslip
in quanto tale criterio viene applicato al controller. Tuttavia, per chiamare l'azione UpdateSalary
deve identity soddisfare sia il EmployeeOnly
criterio che il HumanResources
criterio.
Se vuoi criteri più complessi, ad esempio l'assunzione di una data di nascita, il calcolo di un'età da esso, il controllo dell'età è 21 o superiore, devi scrivere gestori di criteri personalizzati.
Quando viene creato, identity è possibile assegnare una o più attestazioni rilasciate da una parte attendibile. Un'attestazione è una coppia di valori nome che rappresenta ciò che l'oggetto è, non le operazioni che l'oggetto può eseguire. Ad esempio, potresti avere una patente di guida, rilasciata da un'autorità di patente di guida locale. La patente del conducente ha la data di nascita. In questo caso il nome dell'attestazione sarà DateOfBirth
, il valore dell'attestazione sarà la data di nascita, ad esempio 8th June 1970
e l'autorità emittente sarebbe l'autorità di patente di guida. L'autorizzazione basata sulle attestazioni, al suo più semplice, controlla il valore di un'attestazione e consente l'accesso a una risorsa in base a tale valore. Ad esempio, se si vuole accedere a un night club, il processo di autorizzazione potrebbe essere:
Il responsabile della sicurezza delle porte valuterà il valore della data di nascita e se considerano attendibile l'autorità di certificazione (autorità di patente di guida) prima di concedere l'accesso.
Un identity può contenere più attestazioni con più valori e può contenere più attestazioni dello stesso tipo.
I controlli di autorizzazione basati sulle attestazioni sono dichiarativi: gli sviluppatori li incorporano all'interno del codice, in un controller o in un'azione all'interno di un controller, specificando le attestazioni che l'utente corrente deve possedere e, facoltativamente, il valore che l'attestazione deve contenere per accedere alla risorsa richiesta. I requisiti delle attestazioni sono basati su criteri, lo sviluppatore deve compilare e registrare un criterio che esprime i requisiti delle attestazioni.
Il tipo più semplice di criteri attestazione cerca la presenza di un'attestazione e non controlla il valore.
Compilare e registrare i criteri. Questa operazione viene eseguita come parte della configurazione del servizio di autorizzazione, che in genere fa parte del ConfigureServices()
Startup.cs
file.
public void ConfigureServices(IServiceCollection services)
{
services.AddControllersWithViews();
services.AddRazorPages();
services.AddAuthorization(options =>
{
options.AddPolicy("EmployeeOnly", policy => policy.RequireClaim("EmployeeNumber"));
});
}
In questo caso, i criteri controllano EmployeeOnly
la presenza di un'attestazione EmployeeNumber
nell'oggetto corrente identity.
Applicare quindi il criterio usando la Policy
proprietà sull'attributo [Authorize]
per specificare il nome del criterio;
[Authorize(Policy = "EmployeeOnly")]
public IActionResult VacationBalance()
{
return View();
}
L'attributo [Authorize]
può essere applicato a un intero controller, in questa istanza solo le identità corrispondenti ai criteri potranno accedere a qualsiasi azione nel controller.
[Authorize(Policy = "EmployeeOnly")]
public class VacationController : Controller
{
public ActionResult VacationBalance()
{
}
}
Se si dispone di un controller protetto dall'attributo , ma si vuole consentire l'accesso [Authorize]
anonimo a determinate azioni applicate all'attributo AllowAnonymousAttribute
.
[Authorize(Policy = "EmployeeOnly")]
public class VacationController : Controller
{
public ActionResult VacationBalance()
{
}
[AllowAnonymous]
public ActionResult VacationPolicy()
{
}
}
La maggior parte delle attestazioni è dotata di un valore. È possibile specificare un elenco di valori consentiti durante la creazione dei criteri. L'esempio seguente ha esito positivo solo per i dipendenti il cui numero di dipendente è 1, 2, 3, 4 o 5.
public void ConfigureServices(IServiceCollection services)
{
services.AddControllersWithViews();
services.AddRazorPages();
services.AddAuthorization(options =>
{
options.AddPolicy("Founders", policy =>
policy.RequireClaim("EmployeeNumber", "1", "2", "3", "4", "5"));
});
}
Se il valore dell'attestazione non è un singolo valore o è necessaria una trasformazione, usare RequireAssertion. Per altre informazioni, vedere Usare un func per soddisfare un criterio.
Se si applicano più criteri a un controller o a un'azione, tutti i criteri devono essere passati prima che venga concesso l'accesso. Ad esempio:
[Authorize(Policy = "EmployeeOnly")]
public class SalaryController : Controller
{
public ActionResult Payslip()
{
}
[Authorize(Policy = "HumanResources")]
public ActionResult UpdateSalary()
{
}
}
Nell'esempio precedente qualsiasi identity che soddisfi i EmployeeOnly
criteri può accedere all'azione Payslip
in quanto tale criterio viene applicato al controller. Tuttavia, per chiamare l'azione UpdateSalary
deve identity soddisfare sia il EmployeeOnly
criterio che il HumanResources
criterio.
Se vuoi criteri più complessi, ad esempio l'assunzione di una data di nascita, il calcolo di un'età da esso, il controllo dell'età è 21 o superiore, devi scrivere gestori di criteri personalizzati.
Feedback su ASP.NET Core
ASP.NET Core è un progetto di open source. Selezionare un collegamento per fornire feedback:
Eventi
19 nov, 23 - 21 nov, 23
Partecipa alle sessioni online di Microsoft Ignite create per espandere le tue competenze e aiutarti a risolvere i problemi complessi di oggi.
Iscriviti subito