# ltilibrary/ltiadvantage architecture

> Architecture diagram of the GitHub repository ltilibrary/ltiadvantage, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ltilibrary/ltiadvantage
- Repository: https://github.com/ltilibrary/ltiadvantage

## Overview

This repository is a set of .NET libraries for implementing LTI Advantage platforms and tools. A typical service interaction starts with an LTI launch carrying service claims, then a tool uses the advertised endpoints and scopes; platform developers can implement the corresponding ASP.NET Core endpoints. The libraries also provide protocol models, JWT client-credentials token requests, and an OIDC impersonation handler. The graph reflects documented capabilities and sampled controller/token/validator behavior; wiring among unsampled modules is intentionally not inferred.

Main entry points: [`src/LtiAdvantage/Lti`](https://github.com/ltilibrary/ltiadvantage/tree/master/src/LtiAdvantage/Lti) (Launch Models), [`src/LtiAdvantage.AspNetCore/Utilities/AuthorizationScopePolicyProvider.cs`](https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.AspNetCore/Utilities/AuthorizationScopePolicyProvider.cs) (Scope Policy), [`src/LtiAdvantage.AspNetCore/AssignmentGradeServices/LineItemsControllerBase.cs`](https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.AspNetCore/AssignmentGradeServices/LineItemsControllerBase.cs) (Line Item API), [`src/LtiAdvantage.AspNetCore/AssignmentGradeServices/ScoresControllerBase.cs`](https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.AspNetCore/AssignmentGradeServices/ScoresControllerBase.cs) (Scores API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_protocol["LTI Protocol"]
  node_launch["Launch Models"]
  node_deep["Deep Linking"]
end

subgraph group_services["LTI Services"]
  node_agsmodels["Grade Models"]
  node_nrpsmodels["Membership Models"]
  node_agsclaim["AGS Claim"]
  node_nrpsclaim["NRPS Claim"]
end

subgraph group_aspnet["ASP.NET Core"]
  node_lineitems["Line Item API"]
  node_scores["Scores API"]
  node_results["Results API"]
  node_membership["Membership API"]
  node_agsrequests["AGS Requests"]
  node_nrpsrequest["Membership Request"]
  node_scopepolicy["Scope Policy"]
  node_service_response["Service Response<br/>[ServiceResponse.cs]"]
end

subgraph group_security["Identity And OIDC"]
  node_tokenext["JWT Token Request"]
  node_oidcconfig["OIDC Configuration"]
  node_impersonation["Impersonation Handler"]
end

node_platform(("LTI Platform"))
node_tool(("LTI Tool"))
node_application(("Platform Application"))
node_authorization_server(("Authorization Server"))
node_openid_pipeline["OpenIddict Pipeline"]

node_platform -->|"issues launch"| node_launch
node_launch -->|"carries claims"| node_tool
node_launch -->|"advertises AGS"| node_agsclaim
node_launch -->|"advertises NRPS"| node_nrpsclaim
node_platform -->|"exchanges content links"| node_deep
node_tool -->|"creates link response"| node_deep
node_tool -->|"calls endpoint"| node_lineitems
node_tool -->|"publishes scores"| node_scores
node_tool -->|"requests results"| node_results
node_tool -->|"requests membership"| node_membership
node_agsclaim -->|"describes resources"| node_agsmodels
node_nrpsclaim -->|"describes service"| node_nrpsmodels
node_lineitems -->|"builds request"| node_agsrequests
node_scores -->|"builds request"| node_agsrequests
node_results -->|"builds request"| node_agsrequests
node_membership -->|"builds request"| node_nrpsrequest
node_lineitems -->|"requires scopes"| node_scopepolicy
node_scores -->|"requires scopes"| node_scopepolicy
node_results -->|"requires scopes"| node_scopepolicy
node_membership -->|"requires scopes"| node_scopepolicy
node_application -->|"requests token"| node_tokenext
node_tokenext -->|"sends JWT grant"| node_authorization_server
node_oidcconfig -->|"configures handler"| node_impersonation
node_openid_pipeline -->|"dispatches sign-in"| node_impersonation

click node_launch "https://github.com/ltilibrary/ltiadvantage/tree/master/src/LtiAdvantage/Lti"
click node_deep "https://github.com/ltilibrary/ltiadvantage/tree/master/src/LtiAdvantage/DeepLinking"
click node_agsmodels "https://github.com/ltilibrary/ltiadvantage/tree/master/src/LtiAdvantage/AssignmentGradeServices"
click node_nrpsmodels "https://github.com/ltilibrary/ltiadvantage/tree/master/src/LtiAdvantage/NamesRoleProvisioningService"
click node_agsclaim "https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage/AssignmentGradeServices/AssignmentGradeServicesClaimValueType.cs"
click node_nrpsclaim "https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage/NamesRoleProvisioningService/NamesRoleServiceClaimValueType.cs"
click node_lineitems "https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.AspNetCore/AssignmentGradeServices/LineItemsControllerBase.cs"
click node_scores "https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.AspNetCore/AssignmentGradeServices/ScoresControllerBase.cs"
click node_results "https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.AspNetCore/AssignmentGradeServices/ResultsControllerBase.cs"
click node_membership "https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.AspNetCore/NamesRoleProvisioningService/MembershipControllerBase.cs"
click node_agsrequests "https://github.com/ltilibrary/ltiadvantage/tree/master/src/LtiAdvantage.AspNetCore/AssignmentGradeServices"
click node_nrpsrequest "https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.AspNetCore/NamesRoleProvisioningService/GetMembershipRequest.cs"
click node_scopepolicy "https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.AspNetCore/Utilities/AuthorizationScopePolicyProvider.cs"
click node_service_response "https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.AspNetCore/Lti/ServiceResponse.cs"
click node_tokenext "https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.IdentityModel/Client/HttpClientTokenRequestExtensions.cs"
click node_oidcconfig "https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.Oidc/Configuration/DependencyInjectionExtensions.cs"
click node_impersonation "https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.Oidc/Validation/ImpersonationAuthorizeRequestValidator.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_launch,node_deep toneBlue
class node_agsmodels,node_nrpsmodels,node_agsclaim,node_nrpsclaim toneAmber
class node_lineitems,node_scores,node_results,node_membership,node_agsrequests,node_nrpsrequest,node_scopepolicy,node_service_response,node_authorization_server toneMint
class node_tokenext,node_oidcconfig,node_impersonation toneRose
class node_platform,node_tool,node_application,node_openid_pipeline toneIndigo
```

## Components

### LTI Protocol

- [Launch Models](https://github.com/ltilibrary/ltiadvantage/tree/master/src/LtiAdvantage/Lti): `src/LtiAdvantage/Lti`
- [Deep Linking](https://github.com/ltilibrary/ltiadvantage/tree/master/src/LtiAdvantage/DeepLinking): `src/LtiAdvantage/DeepLinking`

### LTI Services

- [Grade Models](https://github.com/ltilibrary/ltiadvantage/tree/master/src/LtiAdvantage/AssignmentGradeServices): `src/LtiAdvantage/AssignmentGradeServices`
- [Membership Models](https://github.com/ltilibrary/ltiadvantage/tree/master/src/LtiAdvantage/NamesRoleProvisioningService): `src/LtiAdvantage/NamesRoleProvisioningService`
- [AGS Claim](https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage/AssignmentGradeServices/AssignmentGradeServicesClaimValueType.cs): `src/LtiAdvantage/AssignmentGradeServices/AssignmentGradeServicesClaimValueType.cs`
- [NRPS Claim](https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage/NamesRoleProvisioningService/NamesRoleServiceClaimValueType.cs): `src/LtiAdvantage/NamesRoleProvisioningService/NamesRoleServiceClaimValueType.cs`

### ASP.NET Core

- [Line Item API](https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.AspNetCore/AssignmentGradeServices/LineItemsControllerBase.cs): `src/LtiAdvantage.AspNetCore/AssignmentGradeServices/LineItemsControllerBase.cs`
- [Scores API](https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.AspNetCore/AssignmentGradeServices/ScoresControllerBase.cs): `src/LtiAdvantage.AspNetCore/AssignmentGradeServices/ScoresControllerBase.cs`
- [Results API](https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.AspNetCore/AssignmentGradeServices/ResultsControllerBase.cs): `src/LtiAdvantage.AspNetCore/AssignmentGradeServices/ResultsControllerBase.cs`
- [Membership API](https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.AspNetCore/NamesRoleProvisioningService/MembershipControllerBase.cs): `src/LtiAdvantage.AspNetCore/NamesRoleProvisioningService/MembershipControllerBase.cs`
- [AGS Requests](https://github.com/ltilibrary/ltiadvantage/tree/master/src/LtiAdvantage.AspNetCore/AssignmentGradeServices): `src/LtiAdvantage.AspNetCore/AssignmentGradeServices`
- [Membership Request](https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.AspNetCore/NamesRoleProvisioningService/GetMembershipRequest.cs): `src/LtiAdvantage.AspNetCore/NamesRoleProvisioningService/GetMembershipRequest.cs`
- [Scope Policy](https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.AspNetCore/Utilities/AuthorizationScopePolicyProvider.cs): `src/LtiAdvantage.AspNetCore/Utilities/AuthorizationScopePolicyProvider.cs`
- [Service Response](https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.AspNetCore/Lti/ServiceResponse.cs): `src/LtiAdvantage.AspNetCore/Lti/ServiceResponse.cs`

### Identity And OIDC

- [JWT Token Request](https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.IdentityModel/Client/HttpClientTokenRequestExtensions.cs): `src/LtiAdvantage.IdentityModel/Client/HttpClientTokenRequestExtensions.cs`
- [OIDC Configuration](https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.Oidc/Configuration/DependencyInjectionExtensions.cs): `src/LtiAdvantage.Oidc/Configuration/DependencyInjectionExtensions.cs`
- [Impersonation Handler](https://github.com/ltilibrary/ltiadvantage/blob/master/src/LtiAdvantage.Oidc/Validation/ImpersonationAuthorizeRequestValidator.cs): `src/LtiAdvantage.Oidc/Validation/ImpersonationAuthorizeRequestValidator.cs`

### Other components

- **LTI Platform**
- **LTI Tool**
- **Platform Application**
- **Authorization Server**
- **OpenIddict Pipeline**

## Connections

- LTI Platform → Launch Models: issues launch
- Launch Models → LTI Tool: carries claims
- Launch Models → AGS Claim: advertises AGS
- Launch Models → NRPS Claim: advertises NRPS
- LTI Platform → Deep Linking: exchanges content links
- LTI Tool → Deep Linking: creates link response
- LTI Tool → Line Item API: calls endpoint
- LTI Tool → Scores API: publishes scores
- LTI Tool → Results API: requests results
- LTI Tool → Membership API: requests membership
- AGS Claim → Grade Models: describes resources
- NRPS Claim → Membership Models: describes service
- Line Item API → AGS Requests: builds request
- Scores API → AGS Requests: builds request
- Results API → AGS Requests: builds request
- Membership API → Membership Request: builds request
- Line Item API → Scope Policy: requires scopes
- Scores API → Scope Policy: requires scopes
- Results API → Scope Policy: requires scopes
- Membership API → Scope Policy: requires scopes
- Platform Application → JWT Token Request: requests token
- JWT Token Request → Authorization Server: sends JWT grant
- OIDC Configuration → Impersonation Handler: configures handler
- OpenIddict Pipeline → Impersonation Handler: dispatches sign-in
