Inheritance diagram for ilNICKeyRegisteredObjective:

Collaboration diagram for ilNICKeyRegisteredObjective:

Public Member Functions
	getHash ()

	getLabel ()

	isNotable ()

	getPreconditions (Setup\Environment $environment)

	achieve (Setup\Environment $environment)

	isApplicable (Setup\Environment $environment)
	@inheritDoc More...

Public Member Functions inherited from ilSetupObjective
	__construct (Setup\Config $config)

Data Fields
const	MAX_REDIRECTS = 5

const	SOCKET_TIMEOUT = 5

const	ILIAS_NIC_SERVER = "https://nic.ilias.de/index.php"

Protected Member Functions
	getRegistrationProblem (array $nic_response_parts)

	getURLStringForNIC ($settings, \ilSystemFolderSetupConfig $systemfolder_config, \ilHttpSetupConfig $http_config)

	getCurlConnection (string $url)

Additional Inherited Members
Protected Attributes inherited from ilSetupObjective
Setup Config	$config

Detailed Description

Definition at line 23 of file class.ilNICKeyRegisteredObjective.php.

Member Function Documentation

◆ achieve()

ilNICKeyRegisteredObjective::achieve ( Setup\Environment $environment )

Definition at line 54 of file class.ilNICKeyRegisteredObjective.php.

                                                           : Setup\Environment
    {
        $factory = $environment->getResource(Setup\Environment::RESOURCE_SETTINGS_FACTORY);
        $settings = $factory->settingsFor("common");
        $systemfolder_config = $environment->getConfigFor("systemfolder");
        $http_config = $environment->getConfigFor("http");
 
        if (!\ilCurlConnection::_isCurlExtensionLoaded()) {
            throw new Setup\UnachievableException(
                "CURL extension is required to register NIC."
            );
        }
 
        //ATTENTION: This makes ilProxySettings work. It uses global ilSetting...
        $old_settings = $GLOBALS["ilSetting"] ?? null;
        $GLOBALS["ilSetting"] = $settings;
 
        $old_DIC = $GLOBALS["DIC"];
        $GLOBALS["DIC"] = new ILIAS\DI\Container();
        $GLOBALS["DIC"]["ilSetting"] = $GLOBALS["ilSetting"];
 
        $url = $this->getURLStringForNIC($settings, $systemfolder_config, $http_config);
        $req = $this->getCurlConnection($url);
        $response = $req->exec();
        $req->parseResponse($response);
 
 
        if ($req->getInfo()["http_code"] != "200") {
            $settings->set("nic_enabled", "-1");
            throw new Setup\UnachievableException(
                "Could not connect to NIC server at \"" . self::ILIAS_NIC_SERVER . "\""
            );
        }
 
        $status = explode("\n", $req->getResponseBody());
 
        $nic_id = (string) ($status[2] ?? '');
        if ($nic_id === '') {
            $settings->set("nic_enabled", "-1");
            throw new Setup\UnachievableException(
                "Did not receive valid installation id from " .
                "NIC server (\"" . self::ILIAS_NIC_SERVER . "\") for URL: $url" .
                $this->getRegistrationProblem($status)
            );
        }
 
        $settings->set("nic_enabled", "1");
        $settings->set("inst_id", $status[2]);
 
        $GLOBALS["DIC"] = $old_DIC;
        $GLOBALS["ilSetting"] = $old_settings;
 
 
        return $environment;
    }

References $factory, $GLOBALS, XapiProxy\$req, $response, ILIAS\LTI\ToolProvider\$settings, $url, ilCurlConnection\_isCurlExtensionLoaded(), getCurlConnection(), getRegistrationProblem(), and getURLStringForNIC().

Here is the call graph for this function:

◆ getCurlConnection()

ilNICKeyRegisteredObjective::getCurlConnection ( string $url )

protected

Definition at line 177 of file class.ilNICKeyRegisteredObjective.php.

                                                     : \ilCurlConnection
    {
        $req = new \ilCurlConnection($url);
        $req->init();
 
        $req->setOpt(CURLOPT_HEADER, 1);
        $req->setOpt(CURLOPT_RETURNTRANSFER, 1);
        $req->setOpt(CURLOPT_CONNECTTIMEOUT, self::SOCKET_TIMEOUT);
        $req->setOpt(CURLOPT_MAXREDIRS, self::MAX_REDIRECTS);
 
        return $req;
    }

References XapiProxy\$req, and $url.

Referenced by achieve().

Here is the caller graph for this function:

◆ getHash()

ilNICKeyRegisteredObjective::getHash ( )

Definition at line 29 of file class.ilNICKeyRegisteredObjective.php.

                             : string
    {
        return hash("sha256", self::class);
    }

◆ getLabel()

ilNICKeyRegisteredObjective::getLabel ( )

Definition at line 34 of file class.ilNICKeyRegisteredObjective.php.

                              : string
    {
        return "The NIC key is registered at the ILIAS Open Source society";
    }

◆ getPreconditions()

ilNICKeyRegisteredObjective::getPreconditions ( Setup\Environment $environment )

Definition at line 44 of file class.ilNICKeyRegisteredObjective.php.

                                                                    : array
    {
        $http_config = $environment->getConfigFor("http");
        return [
            new \ilNICKeyStoredObjective($this->config),
            new \ilSettingsFactoryExistsObjective(),
            new \ilHttpConfigStoredObjective($http_config)
        ];
    }

◆ getRegistrationProblem()

ilNICKeyRegisteredObjective::getRegistrationProblem ( array $nic_response_parts )

protected

Definition at line 118 of file class.ilNICKeyRegisteredObjective.php.

                                                                        : string
    {
        $error_code = trim((string) ($nic_response_parts[1] ?? ''));
        $message = 'Unknown reason';
 
        switch ($error_code) {
            case 'INIC-F-01':
                $message = "NIC server could not connect to database";
                break;
 
            case 'INIC-F-04':
                $message = "NIC server could not execute query";
                break;
 
            case 'INIC-E-04':
                $message = "The installation name was missing in request, please check your " .
                    "configuration (systemfolder.client.name)";
                break;
 
            case 'INIC-E-08':
                $message = "The http path or contact's lastname was missing in request, please check " .
                    "your configuration (http.path or systemfolder.contact.lastname)";
                break;
 
            case 'INIC-E-09':
                $message = "The contact's firstname was missing in request, please check your " .
                    "configuration (systemfolder.contact.firstname)";
                break;
 
            case 'INIC-E-15':
                $message = "The contact's email address was missing in request, please check your " .
                    "configuration (systemfolder.contact.email)";
                break;
        }
 
        return 'Reason: ' . $message;
    }

References $message.

Referenced by achieve().

Here is the caller graph for this function:

◆ getURLStringForNIC()

ilNICKeyRegisteredObjective::getURLStringForNIC	(		$settings,
		\ilSystemFolderSetupConfig	$systemfolder_config,
		\ilHttpSetupConfig	$http_config
	)

protected

Definition at line 156 of file class.ilNICKeyRegisteredObjective.php.

                                                                                                                                      : string
    {
        $inst_id = (string) $settings->get('inst_id', '0');
        $http_path = $http_config->getHttpPath();
        $host_name = parse_url($http_path)["host"];
 
        $url = self::ILIAS_NIC_SERVER .
                "?cmd=getid" .
                "&inst_id=" . rawurlencode($inst_id) .
                "&hostname=" . rawurlencode($host_name) .
                "&inst_name=" . rawurlencode($systemfolder_config->getClientName() ?? '') .
                "&inst_info=" . rawurlencode($systemfolder_config->getClientDescription() ?? '') .
                "&http_path=" . rawurlencode($http_path) .
                "&contact_firstname=" . rawurlencode($systemfolder_config->getContactFirstname()) .
                "&contact_lastname=" . rawurlencode($systemfolder_config->getContactLastname()) .
                "&contact_email=" . rawurlencode($systemfolder_config->getContactEMail()) .
                "&nic_key=" . rawurlencode($settings->get("nic_key"));
 
        return $url;
    }

References ILIAS\LTI\ToolProvider\$settings, $url, ilSystemFolderSetupConfig\getClientDescription(), ilSystemFolderSetupConfig\getClientName(), ilSystemFolderSetupConfig\getContactEMail(), ilSystemFolderSetupConfig\getContactFirstname(), ilSystemFolderSetupConfig\getContactLastname(), and ilHttpSetupConfig\getHttpPath().

Referenced by achieve().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isApplicable()

ilNICKeyRegisteredObjective::isApplicable ( Setup\Environment $environment )

@inheritDoc

Definition at line 113 of file class.ilNICKeyRegisteredObjective.php.

                                                                : bool
    {
        return true;
    }

◆ isNotable()

ilNICKeyRegisteredObjective::isNotable ( )

Definition at line 39 of file class.ilNICKeyRegisteredObjective.php.

                               : bool
    {
        return true;
    }

Field Documentation

◆ ILIAS_NIC_SERVER

const ilNICKeyRegisteredObjective::ILIAS_NIC_SERVER = "https://nic.ilias.de/index.php"

Definition at line 27 of file class.ilNICKeyRegisteredObjective.php.

◆ MAX_REDIRECTS

const ilNICKeyRegisteredObjective::MAX_REDIRECTS = 5

Definition at line 25 of file class.ilNICKeyRegisteredObjective.php.

◆ SOCKET_TIMEOUT

const ilNICKeyRegisteredObjective::SOCKET_TIMEOUT = 5

Definition at line 26 of file class.ilNICKeyRegisteredObjective.php.

The documentation for this class was generated from the following file:

setup/classes/class.ilNICKeyRegisteredObjective.php

Public Member Functions

Data Fields

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ achieve()

◆ getCurlConnection()

◆ getHash()

◆ getLabel()

◆ getPreconditions()

◆ getRegistrationProblem()

◆ getURLStringForNIC()

◆ isApplicable()

◆ isNotable()

Field Documentation

◆ ILIAS_NIC_SERVER

◆ MAX_REDIRECTS

◆ SOCKET_TIMEOUT