ltilibrary/ltiadvantage

LTI Advantage class library for .NET applications.

LTI Advantage Libraries for .NET

• LtiAdvantage is a library to ease the work of creating an LTI Advantage platform or tool.
• LtiAdvantage.IdentityModel has an HttpClient extension method to request a token using JWT client credentials.
• LtiAdvantage.IdentityServer4 has an Identity Server 4 secret validator that understands the IMS recommended format of client-credentials grant.
• LtiAdvantage.AspNetCore contains ASP.NET Core controller implementations to assist in platform development.
• LtiAdvantage.IntegrationTests integration tests.
• LtiAdvantage.UnitTests unit tests.

NuGet

Library	Release	Prerelease
LtiAdvantage
LtiAdvantage.IdentityModel
LtiAdvantage.IdentityServer4
LtiAdvantage.AspNetCore

Build Status

CI	Env	Status
AppVeyor	Windows
travis-ci	Ubuntu

Getting Started

There are two sample applications you can reference for ideas:

• Sample Tool
• Sample Platform

ltiadvantage's Issues

Feature: Data Privacy Launch support?

It's still early days but is anyone here involved in this or interested in LTI's new Data Privacy Launch? (*)

It "Allows LTI-enabled tools to assist administrative users in managing and executing requests related to data privacy." and we may be asked to implemented this some time in the future.

(*) NOTE: Data Privacy Launch 1.0 is a "Member Base Document" so only accessible as IMS member (which my current company is not).

To be transparent: I don't foresee our customers asking for this any time soon, and hence my team won't be looking into it in more detail any time soon either. If the requirement would arise of course it would be good to share experiences and ideally some dedicated support in this library.

Thanks in advance! Jeroen

LTI Advantage for .Net framework

Hello,

We are looking to update our code to LTI Advantage from 1.1 and noticed that it is built in .net core. Our project is in .net framework. Any suggestions?

Licensing

We noticed that this and all of your other LTI libraries on GitHub (which are a terrific resource!) do not appear to have any license specified. Therefore, technically it is a copyright violation for anyone to use the source code or a fork of it in any projects. Can you please provide an explicit license? MIT would be wonderful if possible. Here's an example project that has the license details configured: https://github.com/icsharpcode/SharpZipLib/blob/master/LICENSE.txt

The NuGet packages are licensed Apache-2.0, but that only covers the NuGet distributions.

suggestion: reuse oAuth2 code from RestSharp

Hi, great to see Lti 1.3 being picked up.
Compared to LtiLibrary, the oAuth1 will have to be replaced with oAuth2.
In previous projects (not on github) I have used the oAuth implementation in https://github.com/restsharp/RestSharp
I suppose reusing those classes can help :-)

Why not next release version as 1.0

Discussed in #78

^{Originally posted by jeroenhabets October 8, 2023}
This library has been successfully used by many companies (though difficult to get data, I personally know of at least a handful) so why the 0.2..-alpha version.

• The core of LTI Advantage is covered, so the existing API will most likely no longer change.
• It's being used successfully for years
• Someone stumbling on this library may be off put by the 0.x / alpha version
• Some companies have a mature versions only policy (1.0 or even 1.1)

So @srijken why not do a release soon and call it 1.0?

P.S. I am planning a major regression test so a release (any release with the latest fixes and improvements) would be welcomed. If there is anything we can do to help, let me know.

Typo in LtiAdvantage.AssignmentGradeServices.GradingProgess enum

Both the file name and enum type have a typo in LtiAdvantage.AssignmentGradeServices.GradingProgess
Missing the letter r in the word Progress

Sample projects "out of date"

The getting stated links in the Readme both lead to Repos that state "This code is out of date*", however it's not clear where you are supposed to go to find examples that are up to date.

Public new nuget version for current master code

New release version for the nuget package

Setting Roles to single value results in incorrect claim value

If I set the Roles property to a single value:

var request = new LtiResourceRequest
{
   // ...
   Roles = new[] { LtiAdvantage.Lti.Role.ContextLearner }
};

Then the claim that gets sent is a string value (which is not correct and causes errors downstream):

"https://purl.imsglobal.org/spec/lti/claim/roles": "http://purl.imsglobal.org/vocab/lis/v2/membership#Learner"

However, if I set multiple values:

var request = new LtiResourceRequest
{
   // ...
   Roles = new[] { LtiAdvantage.Lti.Role.InstitutionLearner, LtiAdvantage.Lti.Role.ContextLearner }
};

Then it correctly sends an array:

"https://purl.imsglobal.org/spec/lti/claim/roles": ["http://purl.imsglobal.org/vocab/lis/v2/institution/person#Learner", "http://purl.imsglobal.org/vocab/lis/v2/membership#Learner"]

I was working around this previously by setting multiple Roles but that is not always appropriate for all Role types

LTI Advantage for .Net framework

We want to implement LTI but did not found any proper get start documentation and working samples for the idea.
Is there any guideline and working sample code idea?

.Net 6

Hi @andyfmiller, @srijken

I am trying to build a "pure" .Net 6 version of the LtiAdvantage library and having numerous difficulties, unit tests not being found and various incompatibilities between JObject and JsonObject and so on (Newtonsoft is no longer needed when there's System.Text.JSon and so on) Do you plan to produce a .Net 6 build of the library or is the current .Net Standard build all we're likely to see? I really wanted a definitive build that leverages full .Net 6, the kind of library we'd build if we were starting afresh with .Net 6 today and had no interest in backward compatibility with .Net Framework etc.

Thanks

Unable to launch the tool from platform

we've tried with sample platform code and trying to launch the tool but unsuccessful.
Step 1:
Try to lunch the tool from platform

Step2 :
To send the request from tool to platform --> https://localhost:44338/connect/authorize

Step3:

Its not redirect back to the tool. Instead it gives below error

No webpage was found for the web address: https://localhost:44338/home/error?errorId=CfDJ8D7JpAcSF21NlB5naY6O_UyFSgwoegOhAu0Mv_SzqNDzAnn5buXLEqDFZl6miaOQBDNpzTPBWyk5dburepdeqRfUAUyaPz7OcaFWBjeptC6LXuCKVWw-YopU9Mx5bGIhBTIzkGYnvJaqRbGihkdpycA-8NNX77lcfYMAC_NHpUSKSbOD7DrgGZP4k1ofiZ3bUfxqSmvnNt5-YSAHxaF87sMg8m_bm38wbLw1wOlB4FGCHoL5xkZHNcPPwFU3VxEUbdQrpflgbAESgzwozVzibafGObOUbxpSeJF4QFtKaPFESc04EZsnrgcWfLSfmO5VNw
HTTP ERROR 404

Feature: Proctoring Services support?

Hi Sander, Andy,

AFAICT the library does not support Proctoring Services (July 2019) yet. Is that correct? And if so, is that something you or someone else has been considering? Do you expect the industry to embrace it?

https://www.imsglobal.org/spec/proctoring/v1p0

Regards, Jeroen (who has changed jobs ;) )

Adding LtiAdvantage to NuGet

Hi Andy, do you have any plans to add this library to NuGet now that the IMS Security Framework has been finalised?

P.S Great work on this, helped me a lot with understanding how LTI 1.3 works. Thanks.

Supporting LTI 1.1 and Advantage

I am new to LTI and hoping to support LTI 1.1 (which many SIS / LMS currently support) as well as LTI Advantage. I am having a hard time finding test environments or scenarios to make sure that my LTI Tool works. Any ideas? I found the LTI Advantage Tool... but I need something that will ensure that my code will work with LTI 1.1.