Die mit Icecast 2.5.0 gelieferte Konfiguration enthält Authentifizierungsrollen und verarbeitet zugleich ältere Kennwort- und Mount-Authentifizierungsformen zur Kompatibilität. Das Webhandbuch beschreibt noch viele ältere Formen. Ziehen Sie für eine neue Rollenregel das konkrete Release-Beispiel und den Parser heran.
Auswahl und Berechtigung unterscheiden
Eine Rolle kann Anfragen nach HTTP-Methode und weiteren Filtern auswählen. Anschließend prüft der Authentifizierer die Anfrage. Die zugehörige Zugriffsregel bestimmt, was ein erfolgreich angemeldeter Client tun darf. Eine passende Rolle allein erlaubt nicht sämtliche Verwaltungsbefehle.
| Element oder Attribut | Aufgabe |
|---|---|
role type | Wählt etwa static, htpasswd, url oder anonymous |
name | Benennt eine Rolle zur Zuordnung |
match-method | Begrenzt die berücksichtigten Anfragemethoden |
allow-method / deny-method | Steuert erlaubte Methoden |
allow-web / deny-web | Steuert Zugriff auf Webressourcen |
allow-admin / deny-admin | Steuert Verwaltungsoperationen |
connections-per-user | Regelt Verbindungen pro Benutzer in der Rollenrichtlinie |
option | Liefert Einstellungen für den gewählten Authentifizierer |
Ein begrenztes Beispiel lesen
Dieses Rollenfragment gehört in das vorhandene <authentication>-Element eines Mounts unter 2.5.0. Ersetzen Sie den Pfad. Es veranschaulicht Hörermethoden und verweigert ausdrücklich Verwaltung; es ist keine vollständige Serverregel:
<role type="htpasswd" name="listeners"
match-method="get,head" allow-method="get,head"
allow-web="*" deny-admin="*" connections-per-user="1">
<option name="filename" value="/ABSOLUTE/PRIVATE/PATH/listeners"/>
</role>
<role type="anonymous" match-method="get,head" deny-all="*"/>Konfigurieren Sie Quellen- und Administratorzugang getrennt. Eine uneingeschränkt erlaubende anonyme Rolle darf die erforderliche Hörerprüfung nicht vorwegnehmen. Unterstellen Sie ebenso wenig, dass ein neuer Block automatisch jedes ältere Konto ersetzt. Der Parser von 2.5.0 erzeugt und kombiniert Kompatibilitätsrollen für ältere globale Zugangsdaten.
Eine Regel als Prüfmatrix abnehmen
Prüfen Sie den Hörerabruf anonym, mit falschem Kennwort und mit gültigem Benutzer. Testen Sie Source-Verbindung, Verwaltung und Webdateien gesondert mit den vorgesehenen Konten und Methoden. Beziehen Sie erlaubte und verweigerte Operationen ein. Lesen Sie Konfigurationswarnungen, bevor Sie ein Neuladen als erfolgreich bewerten.
Der XML-Ausschnitt ist anhand des Quellcodes belegt und kann syntaktisch geprüft werden. Sein vollständiges Berechtigungsverhalten benötigt weiterhin einen Test Ihrer konkreten Serverkonfiguration. Ein funktionierendes Hörerkonto belegt keine Einschränkung anderer Verwaltungsrechte.