Inheritance diagram for ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest:

Collaboration diagram for ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest:

Public Member Functions
	testDisabledFactory ()

	testFromEmptyArrayIsDisabled ()

	testFromArrayWithFullSpecExample ()

	testBareHostnamesGetHttpsScheme ()

	testTrailingSlashIsStripped ()

	testActivatedWithoutContentDomainIsForcedOff ()

	testActivatedWithoutIliasDomainStaysActiveWithNullIliasDomain ()

	testInactiveStillParsesDomains ()

	testUnusableDomainsNormalizeToNull (mixed $value)

	testToArrayUsesSpecKeys ()

	testFromArrayToArrayRoundtripIsStable ()

	testValidValuesNormalizeToBareOrigin (string $input, string $expected_domain, string $expected_host)

	testNonBareOriginsAreRejected (string $input)

	testOriginFromUrlReducesTrustedAppUrlToBareOrigin (?string $input, ?string $expected)

	testFromArtefactWithoutFileIsDisabled ()

	testFromArtefactReadsTheStoredSettings ()

	testFromArtefactWithNonArrayContentIsDisabled ()

	testFromArtefactWithoutReturnValueIsDisabled ()

Static Public Member Functions
static	unusableDomainProvider ()

static	originNormalizationProvider ()

static	rejectedOriginProvider ()

static	trustedOriginProvider ()

Protected Member Functions
	tearDown ()

Private Member Functions
	artefact (string $php)

Private Attributes
array	$artefacts = []

Detailed Description

Author: Fabian Schmid fabia.nosp@m.n@sr.nosp@m..solu.nosp@m.tion.nosp@m.s

Definition at line 30 of file IsolationConfigTest.php.

Member Function Documentation

◆ artefact()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::artefact ( string $php )

private

Definition at line 260 of file IsolationConfigTest.php.

                                          : string
    {
        $path = (string) tempnam(sys_get_temp_dir(), 'iso_artefact_') . '.php';
        file_put_contents($path, $php);
        $this->artefacts[] = $path;
        return $path;
    }

◆ originNormalizationProvider()

static ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::originNormalizationProvider ( )

static

Definition at line 205 of file IsolationConfigTest.php.

                                                        : \Iterator
    {
        yield 'bare host gets https' => ['content.example.org', 'https://content.example.org', 'content.example.org'];
        yield 'https kept' => ['https://content.example.org', 'https://content.example.org', 'content.example.org'];
        yield 'http kept' => ['http://localhost', 'http://localhost', 'localhost'];
        yield 'port preserved' => ['https://content.example.org:8443', 'https://content.example.org:8443', 'content.example.org'];
        yield 'host lowercased' => ['https://Content.Example.ORG', 'https://content.example.org', 'content.example.org'];
        yield 'root slash stripped' => ['https://content.example.org/', 'https://content.example.org', 'content.example.org'];
    }

◆ rejectedOriginProvider()

static ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::rejectedOriginProvider ( )

static

Definition at line 228 of file IsolationConfigTest.php.

                                                   : \Iterator
    {
        yield 'with path' => ['https://content.example.org/foo'];
        yield 'with userinfo' => ['https://user:pass@content.example.org'];
        yield 'with query' => ['https://content.example.org/?a=b'];
        yield 'with fragment' => ['https://content.example.org/#x'];
        yield 'ftp scheme' => ['ftp://content.example.org'];
        yield 'file scheme' => ['file:///etc/passwd'];
        yield 'javascript scheme' => ['javascript:alert(1)'];
    }

◆ tearDown()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::tearDown ( )

protected

Definition at line 268 of file IsolationConfigTest.php.

                                 : void
    {
        foreach ($this->artefacts as $path) {
            if (is_file($path)) {
                unlink($path);
            }
        }
        $this->artefacts = [];
    }

◆ testActivatedWithoutContentDomainIsForcedOff()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::testActivatedWithoutContentDomainIsForcedOff ( )

Definition at line 97 of file IsolationConfigTest.php.

                                                                  : void
    {
        $config = IsolationConfig::fromArray([
            IsolationConfig::KEY_ACTIVATED => true,
            IsolationConfig::KEY_ILIAS_DOMAIN => 'https://app.example.org',
        ]);
 
        $this->assertFalse($config->isActivated());
    }

References ILIAS\FileDelivery\Isolation\IsolationConfig\fromArray(), ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_ACTIVATED, and ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_ILIAS_DOMAIN.

Here is the call graph for this function:

◆ testActivatedWithoutIliasDomainStaysActiveWithNullIliasDomain()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::testActivatedWithoutIliasDomainStaysActiveWithNullIliasDomain ( )

Definition at line 107 of file IsolationConfigTest.php.

                                                                                   : void
    {
        // The ILIAS domain is optional in the artefact: when http_path could not
        // be resolved at build time it is simply null (the CORS allow-origin
        // header is then omitted), isolation stays on.
        $config = IsolationConfig::fromArray([
            IsolationConfig::KEY_ACTIVATED => true,
            IsolationConfig::KEY_CONTENT_DOMAIN => 'https://content.example.org',
        ]);
 
        $this->assertTrue($config->isActivated());
        $this->assertSame('https://content.example.org', $config->getContentDomain());
        $this->assertNull($config->getIliasDomain());
    }

References ILIAS\FileDelivery\Isolation\IsolationConfig\fromArray(), ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_ACTIVATED, and ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_CONTENT_DOMAIN.

Here is the call graph for this function:

◆ testBareHostnamesGetHttpsScheme()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::testBareHostnamesGetHttpsScheme ( )

Definition at line 71 of file IsolationConfigTest.php.

                                                     : void
    {
        $config = IsolationConfig::fromArray([
            IsolationConfig::KEY_ACTIVATED => true,
            IsolationConfig::KEY_CONTENT_DOMAIN => 'content.example.org',
            IsolationConfig::KEY_ILIAS_DOMAIN => 'app.example.org',
        ]);
 
        $this->assertSame('https://content.example.org', $config->getContentDomain());
        $this->assertSame('https://app.example.org', $config->getIliasDomain());
        $this->assertSame('content.example.org', $config->getContentHost());
        $this->assertSame('app.example.org', $config->getIliasHost());
    }

References ILIAS\FileDelivery\Isolation\IsolationConfig\fromArray(), ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_ACTIVATED, ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_CONTENT_DOMAIN, and ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_ILIAS_DOMAIN.

Here is the call graph for this function:

◆ testDisabledFactory()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::testDisabledFactory ( )

Definition at line 35 of file IsolationConfigTest.php.

                                         : void
    {
        $config = IsolationConfig::disabled();
 
        $this->assertFalse($config->isActivated());
        $this->assertNull($config->getContentDomain());
        $this->assertNull($config->getIliasDomain());
        $this->assertNull($config->getContentHost());
        $this->assertNull($config->getIliasHost());
    }

References ILIAS\FileDelivery\Isolation\IsolationConfig\disabled().

Here is the call graph for this function:

◆ testFromArrayToArrayRoundtripIsStable()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::testFromArrayToArrayRoundtripIsStable ( )

Definition at line 175 of file IsolationConfigTest.php.

                                                           : void
    {
        $source = [
            IsolationConfig::KEY_ACTIVATED => true,
            IsolationConfig::KEY_CONTENT_DOMAIN => 'content.example.org',
            IsolationConfig::KEY_ILIAS_DOMAIN => 'app.example.org',
        ];
 
        $once = IsolationConfig::fromArray($source)->toArray();
        $twice = IsolationConfig::fromArray($once)->toArray();
 
        $this->assertSame($once, $twice);
    }

References ILIAS\FileDelivery\Isolation\IsolationConfig\fromArray(), ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_ACTIVATED, ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_CONTENT_DOMAIN, and ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_ILIAS_DOMAIN.

Here is the call graph for this function:

◆ testFromArrayWithFullSpecExample()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::testFromArrayWithFullSpecExample ( )

Definition at line 55 of file IsolationConfigTest.php.

                                                      : void
    {
        // exact artefact shape from the feature spec
        $config = IsolationConfig::fromArray([
            IsolationConfig::KEY_ACTIVATED => true,
            IsolationConfig::KEY_CONTENT_DOMAIN => 'https://test11.iliascontent.de',
            IsolationConfig::KEY_ILIAS_DOMAIN => 'https://test11.ilias.de',
        ]);
 
        $this->assertTrue($config->isActivated());
        $this->assertSame('https://test11.iliascontent.de', $config->getContentDomain());
        $this->assertSame('https://test11.ilias.de', $config->getIliasDomain());
        $this->assertSame('test11.iliascontent.de', $config->getContentHost());
        $this->assertSame('test11.ilias.de', $config->getIliasHost());
    }

References ILIAS\FileDelivery\Isolation\IsolationConfig\fromArray(), ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_ACTIVATED, ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_CONTENT_DOMAIN, and ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_ILIAS_DOMAIN.

Here is the call graph for this function:

◆ testFromArtefactReadsTheStoredSettings()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::testFromArtefactReadsTheStoredSettings ( )

Definition at line 287 of file IsolationConfigTest.php.

                                                            : void
    {
        $path = $this->artefact(
            "<?php return ['activated' => true, 'content_domain' => 'content.example.org',"
            . " 'ilias_domain' => 'https://app.example.org'];"
        );
        $config = IsolationConfig::fromArtefact($path);
 
        $this->assertTrue($config->isActivated());
        $this->assertSame('https://content.example.org', $config->getContentDomain());
        $this->assertSame('https://app.example.org', $config->getIliasDomain());
    }

References ILIAS\FileDelivery\Isolation\IsolationConfig\fromArtefact().

Here is the call graph for this function:

◆ testFromArtefactWithNonArrayContentIsDisabled()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::testFromArtefactWithNonArrayContentIsDisabled ( )

Definition at line 300 of file IsolationConfigTest.php.

                                                                   : void
    {
        $config = IsolationConfig::fromArtefact($this->artefact('<?php return "nonsense";'));
 
        $this->assertFalse($config->isActivated());
        $this->assertNull($config->getContentDomain());
    }

References ILIAS\FileDelivery\Isolation\IsolationConfig\fromArtefact().

Here is the call graph for this function:

◆ testFromArtefactWithoutFileIsDisabled()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::testFromArtefactWithoutFileIsDisabled ( )

Definition at line 278 of file IsolationConfigTest.php.

                                                           : void
    {
        $config = IsolationConfig::fromArtefact(sys_get_temp_dir() . '/does_not_exist_isolation.php');
 
        $this->assertFalse($config->isActivated());
        $this->assertNull($config->getContentDomain());
        $this->assertNull($config->getIliasDomain());
    }

References ILIAS\FileDelivery\Isolation\IsolationConfig\fromArtefact().

Here is the call graph for this function:

◆ testFromArtefactWithoutReturnValueIsDisabled()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::testFromArtefactWithoutReturnValueIsDisabled ( )

Definition at line 308 of file IsolationConfigTest.php.

                                                                  : void
    {
        $config = IsolationConfig::fromArtefact($this->artefact('<?php // nothing returned'));
 
        $this->assertFalse($config->isActivated());
        $this->assertNull($config->getContentDomain());
    }

References ILIAS\FileDelivery\Isolation\IsolationConfig\fromArtefact().

Here is the call graph for this function:

◆ testFromEmptyArrayIsDisabled()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::testFromEmptyArrayIsDisabled ( )

Definition at line 46 of file IsolationConfigTest.php.

                                                  : void
    {
        $config = IsolationConfig::fromArray([]);
 
        $this->assertFalse($config->isActivated());
        $this->assertNull($config->getContentDomain());
        $this->assertNull($config->getIliasDomain());
    }

References ILIAS\FileDelivery\Isolation\IsolationConfig\fromArray().

Here is the call graph for this function:

◆ testInactiveStillParsesDomains()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::testInactiveStillParsesDomains ( )

Definition at line 122 of file IsolationConfigTest.php.

                                                    : void
    {
        $config = IsolationConfig::fromArray([
            IsolationConfig::KEY_ACTIVATED => false,
            IsolationConfig::KEY_CONTENT_DOMAIN => 'https://content.example.org',
            IsolationConfig::KEY_ILIAS_DOMAIN => 'https://app.example.org',
        ]);
 
        $this->assertFalse($config->isActivated());
        $this->assertSame('https://content.example.org', $config->getContentDomain());
        $this->assertSame('https://app.example.org', $config->getIliasDomain());
    }

References ILIAS\FileDelivery\Isolation\IsolationConfig\fromArray(), ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_ACTIVATED, ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_CONTENT_DOMAIN, and ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_ILIAS_DOMAIN.

Here is the call graph for this function:

◆ testNonBareOriginsAreRejected()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::testNonBareOriginsAreRejected ( string $input )

Definition at line 216 of file IsolationConfigTest.php.

                                                                : void
    {
        $config = IsolationConfig::fromArray([
            IsolationConfig::KEY_ACTIVATED => false,
            IsolationConfig::KEY_CONTENT_DOMAIN => $input,
            IsolationConfig::KEY_ILIAS_DOMAIN => 'https://app.example.org',
        ]);
 
        $this->assertNull($config->getContentDomain());
        $this->assertNull($config->getContentHost());
    }

References ILIAS\FileDelivery\Isolation\IsolationConfig\fromArray(), ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_ACTIVATED, ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_CONTENT_DOMAIN, and ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_ILIAS_DOMAIN.

Here is the call graph for this function:

◆ testOriginFromUrlReducesTrustedAppUrlToBareOrigin()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::testOriginFromUrlReducesTrustedAppUrlToBareOrigin	(	?string	$input,
		?string	$expected
	)

Definition at line 240 of file IsolationConfigTest.php.

                                                                                                        : void
    {
        // originFromUrl is used at build time to derive the ILIAS domain from
        // http_path, which may carry a sub-directory path that must be discarded.
        $this->assertSame($expected, IsolationConfig::originFromUrl($input));
    }

References ILIAS\FileDelivery\Isolation\IsolationConfig\originFromUrl().

Here is the call graph for this function:

◆ testToArrayUsesSpecKeys()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::testToArrayUsesSpecKeys ( )

Definition at line 160 of file IsolationConfigTest.php.

                                             : void
    {
        $config = IsolationConfig::fromArray([
            IsolationConfig::KEY_ACTIVATED => true,
            IsolationConfig::KEY_CONTENT_DOMAIN => 'https://content.example.org',
            IsolationConfig::KEY_ILIAS_DOMAIN => 'https://app.example.org',
        ]);
 
        $this->assertSame([
            IsolationConfig::KEY_ACTIVATED => true,
            IsolationConfig::KEY_CONTENT_DOMAIN => 'https://content.example.org',
            IsolationConfig::KEY_ILIAS_DOMAIN => 'https://app.example.org',
        ], $config->toArray());
    }

References ILIAS\FileDelivery\Isolation\IsolationConfig\fromArray(), ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_ACTIVATED, ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_CONTENT_DOMAIN, and ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_ILIAS_DOMAIN.

Here is the call graph for this function:

◆ testTrailingSlashIsStripped()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::testTrailingSlashIsStripped ( )

Definition at line 85 of file IsolationConfigTest.php.

                                                 : void
    {
        $config = IsolationConfig::fromArray([
            IsolationConfig::KEY_ACTIVATED => true,
            IsolationConfig::KEY_CONTENT_DOMAIN => 'https://content.example.org/',
            IsolationConfig::KEY_ILIAS_DOMAIN => 'https://app.example.org/',
        ]);
 
        $this->assertSame('https://content.example.org', $config->getContentDomain());
        $this->assertSame('https://app.example.org', $config->getIliasDomain());
    }

References ILIAS\FileDelivery\Isolation\IsolationConfig\fromArray(), ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_ACTIVATED, ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_CONTENT_DOMAIN, and ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_ILIAS_DOMAIN.

Here is the call graph for this function:

◆ testUnusableDomainsNormalizeToNull()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::testUnusableDomainsNormalizeToNull ( mixed $value )

Definition at line 136 of file IsolationConfigTest.php.

                                                                    : void
    {
        $config = IsolationConfig::fromArray([
            IsolationConfig::KEY_ACTIVATED => true,
            IsolationConfig::KEY_CONTENT_DOMAIN => $value,
            IsolationConfig::KEY_ILIAS_DOMAIN => 'https://app.example.org',
        ]);
 
        // unusable content domain -> null -> isolation forced off
        $this->assertNull($config->getContentDomain());
        $this->assertFalse($config->isActivated());
    }

References ILIAS\FileDelivery\Isolation\IsolationConfig\fromArray(), ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_ACTIVATED, ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_CONTENT_DOMAIN, and ILIAS\FileDelivery\Isolation\IsolationConfig\KEY_ILIAS_DOMAIN.

Here is the call graph for this function:

◆ testValidValuesNormalizeToBareOrigin()

ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::testValidValuesNormalizeToBareOrigin	(	string	$input,
		string	$expected_domain,
		string	$expected_host
	)

Definition at line 190 of file IsolationConfigTest.php.

     : void {
        $config = IsolationConfig::fromArray([
            IsolationConfig::KEY_ACTIVATED => false,
            IsolationConfig::KEY_CONTENT_DOMAIN => $input,
            IsolationConfig::KEY_ILIAS_DOMAIN => 'https://app.example.org',
        ]);
 
        $this->assertSame($expected_domain, $config->getContentDomain());
        $this->assertSame($expected_host, $config->getContentHost());
    }

◆ trustedOriginProvider()

static ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::trustedOriginProvider ( )

static

Definition at line 247 of file IsolationConfigTest.php.

                                                  : \Iterator
    {
        yield 'bare origin' => ['https://app.example.org', 'https://app.example.org'];
        yield 'path discarded' => ['https://app.example.org/ilias/index.php', 'https://app.example.org'];
        yield 'query discarded' => ['https://app.example.org/?a=b', 'https://app.example.org'];
        yield 'bare host gets https' => ['app.example.org', 'https://app.example.org'];
        yield 'http kept' => ['http://localhost/sub', 'http://localhost'];
        yield 'port preserved' => ['https://app.example.org:8443/sub', 'https://app.example.org:8443'];
        yield 'empty stays null' => ['', null];
        yield 'null stays null' => [null, null];
        yield 'non-http scheme rejected' => ['ftp://app.example.org', null];
    }

◆ unusableDomainProvider()

static ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::unusableDomainProvider ( )

static

Definition at line 149 of file IsolationConfigTest.php.

                                                   : \Iterator
    {
        yield 'empty string' => [''];
        yield 'whitespace only' => ['   '];
        yield 'scheme without host' => ['https://'];
        yield 'non-string int' => [123];
        yield 'non-string bool' => [true];
        yield 'null' => [null];
        yield 'array' => [['x']];
    }

Field Documentation

◆ $artefacts

array ILIAS\Tests\FileDelivery\Isolation\IsolationConfigTest::$artefacts = []

private

Definition at line 33 of file IsolationConfigTest.php.

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

components/ILIAS/FileDelivery/tests/Isolation/IsolationConfigTest.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Detailed Description

Member Function Documentation

◆ artefact()

◆ originNormalizationProvider()

◆ rejectedOriginProvider()

◆ tearDown()

◆ testActivatedWithoutContentDomainIsForcedOff()

◆ testActivatedWithoutIliasDomainStaysActiveWithNullIliasDomain()

◆ testBareHostnamesGetHttpsScheme()

◆ testDisabledFactory()

◆ testFromArrayToArrayRoundtripIsStable()

◆ testFromArrayWithFullSpecExample()

◆ testFromArtefactReadsTheStoredSettings()

◆ testFromArtefactWithNonArrayContentIsDisabled()

◆ testFromArtefactWithoutFileIsDisabled()

◆ testFromArtefactWithoutReturnValueIsDisabled()

◆ testFromEmptyArrayIsDisabled()

◆ testInactiveStillParsesDomains()

◆ testNonBareOriginsAreRejected()

◆ testOriginFromUrlReducesTrustedAppUrlToBareOrigin()

◆ testToArrayUsesSpecKeys()

◆ testTrailingSlashIsStripped()

◆ testUnusableDomainsNormalizeToNull()

◆ testValidValuesNormalizeToBareOrigin()

◆ trustedOriginProvider()

◆ unusableDomainProvider()

Field Documentation

◆ $artefacts