Eng eenzeg CiviCRM-URL fir Büro- a VPN-Benotzer: Astellungsschrëtt

En Büro-Laptop soll deeselwechte CiviCRM-Lieszeechen um Schreifdësch an nach eng Kéier vun Doheem iwwer d'VPN opmaachen. D'Design, dat de Kontakt mat de Benotzer iwwerlieft, ass eng kanonesch Adress, sief et https://crm.example.org/, mat engem geneemegten Netzwierkwee vun all Standuert an engem Zertifikat, dat fir dësen Numm gëlteg ass. D'VPN ännert, wéi e Client op Distanz de Server erreecht. Et soll ni d'Identitéit vun der Applikatioun änneren, well an deem Moment, wou et dat mécht, gëtt all generéierte Link, Ëmleedung an Integratiouns-Callback en zweet Probleem, dat geléist muss ginn.

Wielt d'URL, ier dir de Wee wielt

Schreift d'geplangten Adress als éischt op, inklusiv all Wee-Komponent, déi de CMS brauch, a behandelt se als fixe Punkt. Alles anescht an dësem Guide ass en Implementatiounsdetail, dat sech ännere kann, ouni se ze beréieren: wéi eng DNS-Äntwert all Grupp kritt, wéi eng Firewall-Reeg de Listener erlaabt, an ob den Traffic duerch en Tunnel oder duerch en lokale Switch-Port kënnt.

Notéiert véier Wäerter zesummen am Zougangsplang, well se nëmmen als Saz funktionéieren. Déi kanonesch URL. D'Äntwert, déi all Clientgrupp fir dësen Numm kréie soll. De Wee an d'Zougangsreegel fir déi Äntwert. Den Hostnumm, deen de Webserver an d'Zertifikat konfiguréiert si fir ze bedéngen. Wann spéider eppes futti geet, ass dat futti Element eent vun deene véier, an dir wäert wëssen, wéien Dir geännert hutt.

Schrëtt 1: Suergt dofir, datt den Numm fir béid Gruppe richteg opgeléist gëtt

Béid Gruppe solle eng privat Äntwert kréien, déi se wierklech erreeche kënnen, an et ass legitim, datt d'Äntwerten ënnerschiddlech sinn, soulaang den Numm et net ass. LAN-Clienten léisen iwwer den internen Opléiser; VPN-Clienten brauchen eng Opléiserpolitik, déi hinnen déiselwecht Zone gëtt, amplaz d'Ufro an en ëffentlechen Opléiser ze leeën an eng ëffentlech Äntwert ze kréien, déi se net kënnen notzen.

Test den Numm aus all Kontext, amplaz et unzehuelen, an test de Wee onofhängeg vum DNS mat der resolve-Optioun vu curl, déi d'Adress fir eng Ufro festhält:

dig +short crm.example.org
curl -sSI --resolve crm.example.org:443:10.10.5.20 https://crm.example.org/ | head -5

Wann den éischten Test eng Adress zréckschléit, déi de Client net erreeche kann, ass de Problem am Tunnel-Routing oder an der Split-Tunnel-Lëscht. Wann den zweeten Test eng Ëmleedung op en Hostnumm zréckschléit, deen Dir net erwaart hutt, stoppt a liest den Location-Header, well dat ass en Applikatiounsproblem an eng Weeännerung wäert et net fixéieren.

Schrëtt 2: Richt de Webserver, d'Zertifikat an d'CMS-Basis-URL aus

De Listener muss konfiguréiert sinn, fir den kanoneschen Numm ze bedéngen, an d'Zertifikat muss en decken. Duerech d'Adress an hirer Rohform ze browsen ass keng Léisung: et entsteet eng Numm-Diskrepanz, et kann de Cookie-Beräich briechen, an et léiert d'Benotzer duerch Warnungen ze klicken, déi Dir spéider engem Auditeur musst erklären.

Hannert engem Ëmgekehrte Proxy, suergt dofir, datt d'Applikatioun weess, datt d'Ufro iwwer HTTPS koum. Déi meescht CMS-Plattformen generéieren absolut Linken aus dem erkannte Schema, an e Proxy, deen TLS ofschléisst, ouni dat ursprénglecht Schema weiderzereechen, erstellt eng Säit voller http://-Ressourcen, déi de Browser ka blocken. Konfiguréiert den vertraute Proxy an déi weidergeleet Headeren explizit, amplaz d'Applikatioun roden ze loossen.

Richt dann d'Basis-URL vum CMS an CiviCRM aus. CiviCRM behält seng bestëmmt Basis-URL a bitt eng ënnerstëtzte Manéier, se nei ze berechnen: d'administrativ Aktioun Cleanup Caches and Update Paths, dokumentéiert am Leitfueden zur Fehlerbehandlung bei der CiviCRM-Installatioun. Féiert se aus, nodeems den kanoneschen Numm an d'CMS-Astellung iwwerenee stëmmen, net virdrun, soss cache Dir just e Wäert, deen Dir grad ännere wëllt.

cv flush
# then Administer > System Settings > Cleanup Caches and Update Paths

Schrëtt 3: Iwwerpréift d'Adressen, déi CiviCRM generéiert

D'Startsäit z'erreechen beweist ganz wéineg. CiviCRM leeft bannen an engem CMS, an déi Säite wou et drop u kënnt, si déi, déi hir eege URLen opbauen: d'Login-Ëmleedung, d'Administratiounsmenü, Extensiounsressourcen, Linken op eropgeluede Fichieren an all externen Callback, deen eng Integratioun registréiert.

Luet den Dashboard, maacht e Kontaktop, a kuckt de Quelltext vun der Säit no absoluten Linken. Wann se op en Hostnumm weisen, deen nëmmen eng Clientgrupp erreeche kann, ass d'Basis-URL nach ëmmer falsch, obwuel d'Säit ugewise gouf. Wann se op den richtege Numm awer dat falscht Schema weisen, ass d'Proxy-Konfiguratioun dat, wat muss korrigéiert ginn.

Wou d'Adress wierklech muss geännert ginn, behandelt et als Applikatiounsmigratioun an net als DNS-Ännerung. Iwwerpréift Ressourcen-URLen, Cachen, verëffentlecht Linken an all extern Integratioun, déi déi al Adress späichert, an aktualiséiert se duerno an engem Fënster, sou datt keen en hallef migréierte Lieszeechen hält.

En Ufro-Hostnumm ass keng Vertrauensentscheedung

Wielt keng privilegiéiert Basis-URL, well en Ufro-Header eng bestëmmte String enthält. PHP dokumentéiert Apache-Konfiguratiounen, an deenen de Servernumm-Wäert en Host reflektéiere kann, deen de Client uginn huet, an d'Variabel fir d'Serveradress beschreift de Server, net d'Plaz vum Besicher. Keen vun deenen zwee ass en Zougangskontrollmechanismus, an een doraus ze bauen ass de Wee, wéi en private Service um Enn de falschen Inhalt un de falschen Host liwwert.

Wann wierklech méi Hostnimm néideg sinn, konfiguréiert eng explizit Erlaabnislëscht um Webserver, am CMS an an der Applikatiounsschicht, a loosst den Ufro-Hostnumm nëmmen aus geneemegten Asätz wielen. Belibegt Input soll ni d'Quell vun absolute Linken oder en vertraut Ëmleedungszil ginn.

Schléisst mam selwechte Lieszeechen an all geneemegtem Kontext of: en Login, eng gewéinlech intern Navigatioun an eng Ressourcenufro. Vergläicht d'Hostnimm an den Äntwerten, net just ob d'Säit gelueden huet. Dës Kontroll mat dräi Ufroen trennt e Weeproblem vun enger Applikatioun, déi nach ëmmer déi falsch Adress generéiert, an se dauert ongeféier eng Minutt pro Clientgrupp.