oat-sa/extension-tao-lti

extension to manage LTI services for TAO

TAO taoLti extension

, _(*1)

, _(*2)

Extension to manage LTI services for TAO, _(*3)

Installation instructions

These instructions assume that you have already a TAO installation on your system. If you don't, go to package/tao and follow the installation instructions., _(*4)

If you installed your TAO instance through package/tao, oat-sa/extension-tao-lti is very likely already installed. You can verify this under Settings -> Extension manager, where it would appear on the left hand side as taoLti. Alternatively you would find it in the code at /config/generis/installation.conf.php., _(*5)

Note, that you have to be logged in as System Administrator to do this., _(*6)

Add the extension to your TAO composer and to the autoloader:, _(*7)

composer require oat-sa/extension-tao-lti

Install the extension on the CLI from the project root:, _(*8)

Linux:, _(*9)

sudo php tao/scripts/installExtension oat-sa/extension-tao-lti

Windows:, _(*10)

php tao\scripts\installExtension oat-sa/extension-tao-lti

As a system administrator you can also install it through the TAO Extension Manager: - Settings (the gears on the right hand side of the menu) -> Extension manager - Select taoLti on the right hand side, check the box and hit install, _(*11)

REST API

Lti REST API, _(*12)

Configuration options

ServiceOptions.conf.php

Description: this specifies LTI client configuration., _(*13)

If the configuration file is not present as ../config/generis/ServiceOptions.conf.php, create it by copying from ../generis/config/default/ServiceOptions.conf.php., _(*14)

Example, _(*15)

<?php

return new oat\generis\model\DependencyInjection\ServiceOptions(
    [
        oat\taoLti\models\classes\Client\LtiClientFactory::class => [
            'config' => [    // This configuration accepts
                'proxy' => [ // [Guzzle Request Options](https://docs.guzzlephp.org/en/stable/request-options.html)
                    'http'  => 'http://localhost:8125',
                    'https' => 'https://localhost:9124',
                ],
            ],
        ],
    ]
);

auth.conf.php

Configuration option config

Description: this specifies a single option as the adapter key of the array. This adapter is to be used to authenticate LTI requests and is retrieved in FactoryLtiAuthAdapterService., _(*16)

Possible values of the adapter key: * an instance of any class that implements the common_user_auth_Adapter interface, _(*17)

Value examples: * ['config' => ['adapter' => 'oat\\taoLti\\models\\classes\\LtiAuthAdapter']], _(*18)

CookieVerifyService.conf.php

Configuration option verify_cookie

Description: This option determine whether to check if the 'session' request parameter matches the internal PHP session ID before launching an LTI tool, _(*19)

Possible values: * true: enable the session check. 2 more HTTP redirects are needed * false: disable the session check, _(*20)

LtiUserService.conf.php

Configuration option factoryLtiUser

Description: factory for producing LTI users, _(*21)

Possible values: * an instance of any class that implements the oat\taoLti\models\classes\user\LtiUserFactoryInterface interface, _(*22)

Configuration option transaction-safe (only for OntologyLtiUserService implementation)

Description: not used, _(*23)

Configuration option transaction-safe-retry (only for OntologyLtiUserService implementation)

Description: not used, _(*24)

Configuration option lti_ku_ (only for KvLtiUserService implementation)

Description: a prefix for storing taoId => ltiId relation in the key-value storage to look up LTI users, _(*25)

Possible values: * any unique string, _(*26)

Configuration option lti_ku_lkp_ (only for KvLtiUserService implementation)

Description: a prefix for storing ltiId => taoId relation in the key-value storage to execute reverse lookup, _(*27)

Possible values: * any unique string, _(*28)

LtiValidatorService.conf.php

Configuration option launchDataValidator

Description: specifies a list of validators to be used for validating LTI launch data, _(*29)

Possible values: * a list of instances of any classes that implement the LtiValidatorInterface interface. Validators should throw LtiException in case of not valid data, return values are not considered, _(*30)

Value examples: * [ new oat\taoLti\models\classes\LaunchData\Validator\Lti11LaunchDataValidator() ], _(*31)

Dependency Injection Service Providers

LtiServiceProvider

Configuration for AuthorizationServerFactory

Extension Wiki

You can find the extension wiki here., _(*32)