Viac domén a wildcardy

Jeden certifikát pre viac domén vystavíte odovzdaním poľa do for() alebo pridaním SAN domén cez alsoFor(). Wildcardy sú podporované — pri driveri acme len cez DNS-01:

// requires a DnsChallengeSolver in drivers.acme.solver
Certificates::for(['app.example.com', '*.app.example.com'])->using('acme')->issue();

Certificates::for('example.com')
    ->alsoFor('www.example.com', 'api.example.com')
    ->using('acme')
    ->issue();

Prvá doména je primárna: ukladá sa do stĺpca domain a určuje odvodený názov certifikátu. Pri viac ako jednej doméne sa celý zoznam uloží do doplnkového JSON stĺpca domains.

Vyhľadanie pokrývajúceho certifikátu

Scope coveringDomain nájde záznamy, ktorých primárna doména sa zhoduje s hostiteľom alebo ktorých zoznam SAN domén ho obsahuje:

use RoundlyConsulting\Certificates\Models\Certificate;

$certificate = Certificate::query()->coveringDomain('www.example.com')->first();

$certificate->domain;   // 'example.com' — the primary domain
$certificate->domains;  // ['example.com', 'www.example.com', 'api.example.com']

Podpora driverov

Drivery s ProvisionsMultipleDomains — acme, filesystem, kubernetes a array — dostanú celý zoznam jedným volaním generateMany(): jedna ACME objednávka, jeden certifikát podpísaný samým sebou alebo jeden TLS záznam v Ingresse. Ostatné (null alebo vlastný driver bez tohto rozhrania) použijú len primárnu doménu. Každá doména sa najprv prevedie na malé písmená, odstránia sa duplicity a overí sa cez ValidDomain; wildcardy *. predvolene prejdú. Obnova znovu vystaví všetky domény, ktoré certifikát pokrýva, takže SAN certifikát si ponechá všetkých hostiteľov.

Certifikačné autority vrátane Let’s Encrypt pre názov *. nikdy neponúkajú HTTP-01, preto najprv zaregistrujte DNS-01 solver — pozri ACME a Let’s Encrypt. S predvoleným HTTP-01 solverom wildcard objednávka zlyhá s AcmeException, ktorá to výslovne uvedie.