Behebung von Cross-Domain-Schriftarten & CORS-Problemen

Beim Erstellen von benutzerdefinierten Dokumentvorlagen, Rechnungen oder externen Portalen in HireHop möchten Sie möglicherweise Ihre eigenen @font-face Webfonts verwenden. Wenn diese Schriftarten jedoch auf einem externen Server oder einer anderen Domain gehostet werden, blockieren Browser sie häufig beim Laden im gerenderten Dokument.

Dieses Problem wird verursacht durch CORS-Sicherheitsbeschränkungen (Cross-Origin Resource Sharing), die das Laden von Webfonts über verschiedene Domains hinweg blockieren, es sei denn, der Ursprungsserver erlaubt dies ausdrücklich.

Schriftarten werden in Dokumenten nicht geladen

Unten ist ein typisches Beispiel dafür, wie ein benutzerdefinierter Webfont in HTML/CSS deklariert wird. Bei der Darstellung über verschiedene Domain-Ursprünge hinweg laden Browser die Schriftart nicht, es sei denn, es sind entsprechende CORS-Header vorhanden:

<style type="text/css">
@font-face {
    font-family: 'OpenSans';
    src: url('https://my_server.com/fonts/OpenSans.woff2') format('woff2');
}
html, body{
    font: normal 16px OpenSans, sans-serif;
}
</style>

Die Lösung

Um die domänenübergreifende Schriftartenblockierung zu beheben, muss Ihr Webserver so konfiguriert sein, dass er einen Access-Control-Allow-OriginHTTP-Header zusammen mit den Schriftartendateien sendet.

Wenn Sie von Dritten gehostete Schriftarten verwenden (wie Google Fonts oder Adobe Typekit), werden CORS-Header automatisch verarbeitet. Wenn Sie jedoch Schriftartdateien (.woff, .woff2, .ttf, .eot) auf Ihrem eigenen Server hosten, wählen Sie unten Ihr Server-Setup aus, um den cross-origin Zugriff zu aktivieren:

Apache (.htaccess)

Um einen Apache-Webserver zu konfigurieren, fügen Sie folgenden Code in die httpd.conf oder .htaccess Datei:

1. Fügen Sie die MIME-Typ-Header in Apache hinzu:

AddType application/vnd.ms-fontobject .eot
AddType application/x-font-opentype   .otf
AddType image/svg+xml                 .svg
AddType application/x-font-ttf        .ttf
AddType application/font-woff         .woff
AddType application/font-woff2        .woff2

2. Aktivieren Sie Cross-Origin Resource Sharing (CORS) in Apache für die MIME-Typen:

<IfModule mod_headers.c>
    <FilesMatch "\.(eot|otf|svg|ttf|woff|woff2)$">
        Header set Access-Control-Allow-Origin "*"
    </FilesMatch>
</IfModule>

Nginx

Um einen NGINX-Webserver zu konfigurieren, fügen Sie den folgenden Code in die /etc/nginx/nginx.conf oder Ihre benutzerdefinierte /etc/nginx/conf.d/custom.conf Datei ein.

1. MIME-Typ-Header hinzufügen:

application/vnd.ms-fontobject    eot;
application/x-font-opentype      otf;
image/svg+xml                    svg;
application/x-font-ttf           ttf;
application/font-woff            woff;
application/font-woff2           woff2;

2. Cross-Origin Resource Sharing (CORS) auf Nginx für die MIME-Typen aktivieren:

location ~* .(eot|otf|svg|ttf|woff|woff2)$ {
    add_header Access-Control-Allow-Origin *;
}

IIS (Microsoft Windows Server)

Um Microsoft IIS zu konfigurieren und CORS zu aktivieren, fügen Sie den folgenden Code zum web.config system.webServer-Block hinzu.

<system.webServer>
  <httpProtocol>
    <customHeaders>
      <add name="access-control-allow-origin" value="*" />
      <add name="access-control-allow-headers" value="content-type" />
    </customHeaders>
  </httpProtocol>
</system.webServer>

Alternative Methode: PHP (Falls Sie keine Serverkonfigurationsdateien bearbeiten können)

Wenn Sie keine Berechtigung haben, die Konfigurationsdateien Ihres Webservers zu ändern (wie httpd.conf, .htaccess, oder nginx.conf), können Sie Schriftartendateien dynamisch über ein PHP-Skript bereitstellen, um die erforderlichen CORS-Header direkt zu senden.

1. PHP-Server-Skriptdatei

Erstellen Sie eine PHP-Datei (z. B. font.php) auf Ihrem Server, um den Origin-Header zu setzen und Ihre Schriftartendatei auszugeben:

<?php
header("Access-Control-Allow-Origin: *");
header("Content-Type: application/font-woff2");
echo file_get_contents("path/to/OpenSans.woff2");
?>

2. CSS-@font-face-Implementierung

<style type="text/css">
@font-face {
  font-family: OpenSans;
  src: url('https://my_domain.com/font.php') format('woff2');
}
body, html {
  font-family: OpenSans, sans-serif;
}
</style>