Speicherformat der Konfigurationsinformationen des CtiServers im ActiveDirectory ohne Schemaerweiterung.

Transkript

1 Technische Dokumentation Kodierung der Parameter des Feldes extensionname in ActiveDirectory Objekten. Speicherformat der Konfigurationsinformationen des CtiServers im ActiveDirectory ohne Schemaerweiterung.

2 extensionname Dokumentation Seite 2 von 13

3 Rechtliche Hinweise / Impressum Die Angaben in diesem Dokument entsprechen dem Kenntnisstand zum Zeitpunkt der Erstellung. Irrtümer und spätere Änderungen sind vorbehalten. Die ESTOS GmbH schließt jegliche Haftung für Schäden aus, die direkt oder indirekt aus der Verwendung dieses Dokumentes entstehen. Alle genannten Marken- und Produktbezeichnungen sind Warenzeichen oder Eigentum der entsprechenden Inhaber. Die derzeit gültigen Allgemeinen Geschäftsbedingungen finden Sie auf unserer Webseite unter Copyright ESTOS GmbH. Alle Rechte vorbehalten. ESTOS GmbH Petersbrunner Str. 3a D Starnberg info@estos.de EWV Dokumenthistorie Version Datum Autor Änderungen STM Initial/Draft STM Erstes Review, Änderungen STM Zweites Review, Änderungen, erste Freigabe extensionname Dokumentation Seite 3 von 13

4 Inhalt Einleitung 5 1 Allgemein Einsatz von extensionname 6 2 Feldbeschreibung Aufbau Details User Object Group Object Computer Object Berechtigungen 12 extensionname Dokumentation Seite 4 von 13

5 Einleitung Dieses Dokument beschreibt den Inhalt des ActiveDirectory (AD) Feldes extensionname, wie es aktuell (Stand ) von ESTOS CtiServer (als Bestandteil von ESTOS Pro- Call 3.0 Enterprise und Baugleichen) zur Speicherung von Konfigurationsdaten bei Benutzer, Gruppen und Computer Objekten verwendet wird. Änderungen können sich jederzeit auch ohne Vorankündigung ergeben. extensionname Dokumentation Seite 5 von 13

6 1 Allgemein 1.1 Einsatz von extensionname Der CtiServer hat bei Verwendung des ActiveDirectory als Benutzerdatenbank zwei Möglichkeiten seine Konfiguration zu speichern: Ohne Schemaerweiterung Es wird an dem Schema des ActiveDirectory nichts geändert und zur Speicherung der Informationen wird ein dafür vorgesehenes Feld namens extensionname verwendet. Dazu werden die Daten mit Hilfe eines speziellen Formates in Text umgewandelt. Mit Schemaerweiterung Für diese Option muss auf dem Schemamaster das Schema des ActiveDirectory um die benötigten Felder erweitert werden. Ist diese Schemaerweiterung installiert, erkennt dies der CtiServer automatisch und verwendet dann zur Speicherung der Konfigurationsdaten die ESTOS eigenen Felder bei Computer, Benutzer und Gruppen. In diesem Dokument wird das Textformat erklärt, welches verwendet wird um das unter 1) erwähnte Textformat näher zu beschreiben. Mehr Details zu der unter 2) erwähnten Schemaerweiterung kann man in der entsprechenden Hilfe nachlesen. Bei der Verwendung von extensionname (also ActiveDirectory Anbindung ohne Schemaerweiterung) gibt es folgendes zu beachten: Funktioniert ohne Änderung des ActiveDirectory-Schemas. Kann mit Software anderer Hersteller zu Kollisionen im extensionname Feld führen. Ist für größere Installationen mit mehr als 100 Benutzern von ESTOS nicht empfohlen, da es systembedingt zu Leistungseinbußen führt (z.b. sind Suchanfragen sehr langsam). Der CtiServer verwendet extensionname nur für Daten, die für seinen Betrieb notwendig sind und nicht bereits in Standardfeldern des ActiveDirectory gespeichert sind. So sind z.b. Username oder DisplayName nicht in extensionname, sondern in den dafür vorgesehenen ActiveDirectory Feldern gespeichert und können auch nur über die ActiveDirectory Konsole geändert werden. extensionname Dokumentation Seite 6 von 13

7 2 Feldbeschreibung 2.1 Aufbau Für die Belegung des extensionname Feldes wird eine Textkodierung vorgenommen. Für die Kodierung gelten allgemein folgende Regeln: extensionname ist ein sog. Multivalue Property. Das Property kann bei jedem Objekt mehrfach vorkommen. Um den gesamten Inhalt zu lesen, müssen alle Properties mit diesem Namen für ein Objekt gelesen werden. Jeder Wert wird in Form von Key / Value Paaren in der Form <Key, Value> abgelegt. Key ist dabei eine Zahl, die angibt, was der Wert in Value bedeutet, so dass der CtiServer den Wert richtig in der Konfiguration zuordnen kann. Im Fall von Listenelementen kann Key mehrfach mit verschiedenen Werten vorkommen. Diese werden dann vom CtiServer als Listenelemente in die entsprechende Liste aufgenommen. Value ist der Wert des Feldes in der CtiServer Konfiguration, der durch Key spezifiziert ist. Die Formatierung ist dabei bei jedem Feld entsprechend der Erfordernisse anders und wird weiter unten in der Detailbeschreibung angegeben. Die Paare müssen jeweils vollständig in einem extensionname Property eingetragen werden. Die Länge einer einzelnen extensionname Property darf 255 Zeichen nicht überschreiten. Nicht belegte Felder werden ohne Value geschrieben: <Key,>. Bitfelder können reservierte Bits enthalten. Diese sollten nicht verändert werden um die Kompatibilität mit zukünftigen Versionen zu erhalten. In Klammern steht der Wert, sollte das Feld neu angelegt werden. Leitungsidentifier sind in der Regel Leitungsrufnummern im superkanonischen Format (z.b ). Es handelt sich dabei jedoch um ein Freitextfeld, welches bei Ausnahmen etwas anderes enthalten kann. In ProCall 3.0 Enterprise oder Baugleichen kommt das nur in Fällen vor, bei denen die Standorteinstellungen nicht oder falsch konfiguriert wurden. Es muss dann entsprechend mit der Anzeige im Admin verglichen werden, welches Format hier der CtiServer erwartet. Im Folgenden werden für die drei verwendeten Objektklassen im ActiveDirectory (User, Group, Computer) noch die jeweils dafür verwendeten Felder und deren Inhalt aufgelistet. Am Ende erfolgt noch die Aufschlüsselung der Struktur für Berechtigungsfelder. extensionname Dokumentation Seite 7 von 13

8 2.2 Details User Object Name Key Value / Beschreibung CTI Enabled 0 Passwort 1 Dienste 2 1: Benutzer ist aktiver CtiServer Benutzer 0: Benutzer hat keinen Zugriff auf den CtiServer Passwort des Benutzers (wird bei Domänenauthentifizierung nicht verwendet). Kann aus Sicherheitsgründen nur vom CtiServer geschrieben werden, da der Inhalt verschlüsselt wird. DWORD, Bitfeld, dezimale Schreibweise 0x : Darf Kurznachrichten versenden 0x : Darf SMS versenden 0x : Reserviert, nicht verändern (0) 0x : Darf ProCall Client verwenden 0x : Reserviert, nicht verändern (0) 0x : Darf sein Benutzerprofil selbst anlegen/ändern 0x : Darf KEINE CTI Leitungen verwenden 0x : Darf Offlinejournal verwenden 0x : Kann Anrufe in Abwesenheit als bekommen 0x : Kann den CallRecorder verwenden 0x : Darf Telefonbücher verwenden 0x : Reserviert, nicht ändern (0) 0x : Benutzer hat alle Benutzer im Monitor 0x : Reserviert, nicht verändern (0) 0x : Reserviert, nicht ändern (0) 0x : Reserviert, nicht ändern (0) 0x : Reserviert, nicht ändern (0) 0x : Reserviert, nicht ändern (0) 0x : Reserviert, nicht ändern (0) 0x : Darf KEIN Journal verwenden 0x x : Reserviert, nicht ändern (0) Zusätzliche Leitungen Rechte 3 DWORD, Bitfeld, dezimale Schreibweise 0x : Status der Leitungen ist sichtbar (besetzt/frei) 0x : Reserviert, nicht ändern (0) 0x : Leitungsfunktionen dürfen genutzt werden (MakeCall) 0x : Reserviert, nicht ändern (0) 0x : Von der Leitung dürfen Anrufe herangeholt werden 0x : Abgehende Rufnummern werden angezeigt 0x x : Reserviert, nicht ändern (0) 0x : Ankommende Rufnummern werden angezeigt 0x x : Reserviert, nicht ändern (0) Primäre Leitung 4 Leitungsidentifier der ersten Leitung, die dem Benutzer zugeordnet ist. Sekundäre Leitung 5 Leitungsidentifier der zweiten Leitung, die dem Benutzer zugeordnet ist. Mobil Rufnummer 6 Mobilrufnummer des Benutzers. Recordingserver Rufnummer 7 Rufnummer eines Recordingsservers. Mailbox Rufnummer 8 Rufnummer der Mailbox des Benutzers (im Moment nicht verwendet). Zusätzliche Leitungen 9 Liste der Leitungsidentifier, die der Benutzer zusätzlich sehen darf. Die Leitungsidentifier werden in ein Value geschrieben und dabei durch getrennt. <09, > Wird die Liste für ein extensionname Feld zu lang, wird diese aufgeteilt und mehrere Einträge mit dem gleichen Key geschrieben. Berechtigungen anderer 10 Liste der Berechtigungen, die der Benutzer anderen Benutzern gegeben extensionname Dokumentation Seite 8 von 13

9 Benutzer Schema Version Erst ab Version vorhanden. 17 hat. Dabei wird jede Berechtigung in ein eigenes <Key, Value> Paar geschrieben und jeweils in ein eigenes "extensionname" Property. Die Berechtigungen werden dabei hexadezimal angegeben (s. Beispiel). Eine genaue Beschreibung der Inhalte steht weiter unten. Die Felder werden durch ; getrennt und durch abgeschlossen. <10, Username;0X ;0X ;0X > Für Version 3 ist der Wert hier 3. Steht hier was anderes, sollten keine Änderung an den Inhalten durchgeführt werden. Beispiel eines Users: <00,1><03,2097><02,1165><01,><04, ><05,><06,><07,><08,><17,3><0 9, > <10,smaier@stmtest.de;0X ;0X ;0X > <10,jbach@stmtest.de;0X ;0X ;0X > extensionname Dokumentation Seite 9 von 13

10 2.2.2 Group Object Name Key Value / Beschreibung CTI Enabled 0 Dienste 2 1: Die Gruppe wird für die Benutzerverwaltung und Vergabe von Berechtigungen vom CtiServer verwendet. 0: Die Gruppe wird im CtiServer nicht berücksichtigt. DWORD, Bitfeld, dezimale Schreibweise 0x : Mitglieder dürfen Kurznachrichten versenden 0x : Mitglieder dürfen SMS versenden 0x : Reserviert, nicht verändern (0) 0x : Reserviert, nicht verändern (0) 0x : Reserviert, nicht verändern (0) 0x : Mitglieder dürfen ihr Benutzerprofil selbst anlegen/ändern 0x x : Reserviert, nicht verändern (0) 0x : Mitglieder dürfen Telefonbücher verwenden 0x : Reserviert, nicht ändern (0) 0x : Benutzer haben alle Mitglieder im Monitor 0x : Reserviert, nicht verändern (0) 0x : Mitglieder können das Journal der Gruppe einsehen 0x : Gruppenleiter kann das Journal der Gruppe einsehen 0x : Mitglieder können Journaleinträge der Gruppe verändern 0x : Reserviert, nicht ändern (0) 0x : Reserviert, nicht ändern (0) 0x : Darf KEIN Journal verwenden 0x x : Reserviert, nicht ändern (0) Gruppenleiter 11 Benutzer DNPath des Gruppenleiters (wenn eingerichtet) Gruppenleiter Stellvertreter Gruppenleiter Berechtigungen Mitglieder Berechtigungen Schema Version Erst ab Version vorhanden. 12 Benutzer DNPath des Stellvertreters des Gruppenleiters (wenn eingerichtet) Die Berechtigungen des Gruppenleiters und dessen Stellvertreters. <13, Groupleader;0X ;0X ;0X > Berechtigungen, die den Gruppenmitgliedern untereinander gegeben werden. <14, Groupname;0X ;0X ;0X > Für Version 3 ist der Wert hier 3. Steht hier was anderes, sollten keine Änderung an den Inhalten durchgeführt werden. <00,1><02,120557><14,CtiBenutzer;0X ;0X ;0X ><13,CtiBenutzer;0X ;0X ;0X ><11,CN=Johann Bach,CN=Users,DC=stmtest,DC=de><12,CN=Sepp Maier,CN=Users,DC=stmtest,DC=de><17,3> extensionname Dokumentation Seite 10 von 13

11 2.2.3 Computer Object Name Key Value / Beschreibung CTI Enabled 0 1: Computer kann Leitungen vom CtiServer beziehen. 0: Computer kann keine Leitungen vom CtiServer beziehen. Multiline TSP Leitungen Berechtigungen 3 DWORD, Bitfeld, dezimale Schreibweise 0x : Besetztanzeige, immer 1 0x : Reserviert, nicht ändern (0) 0x : Leitungsfunktionen nutzen, immer 1 0x : Reserviert, nicht ändern (0) 0x : Anrufe heranholen, immer 1 0x : Abgehende Rufnummern anzeigen, immer 1 0x x : Reserviert, nicht ändern (0) 0x : Leitungseigentümer muss geprüft werden 0x : Eingehende Rufnummern anzeigen, immer 1 0x x : Reserviert, nicht ändern (0) Erste Leitung 4 Leitungsidentifier der ersten Leitung, die dem Computer zugeordnet ist. Zweite Leitung 5 Leitungsidentifier der zweiten Leitung, die dem Computer zugeordnet ist. Multiline TSP Leitungen Schema Version Erst ab Version vorhanden Liste der Leitungsidentifier, die der Benutzer zusätzlich sehen darf. Die Leitungsidentifier in ein Value geschrieben und dabei durch getrennt. <09, > Für Version 3 ist der Wert hier 3. Steht hier was anderes, sollten keine Änderung an den Inhalten durchgeführt werden. <00,1><04, ><05, ><03,2613><17,3><09, > extensionname Dokumentation Seite 11 von 13

12 2.2.4 Berechtigungen Die Berechtigungen werden in einen String und 3 DWORD Bitfelder aufgeteilt. Anmerkung: Für ESTOS ProCall 4.0 und Baugleiche wird der Inhalt entsprechend neuer Anforderungen erweitert und/oder geändert! Der String enthält die Benutzer-ID des Benutzers, der die Berechtigung erhält. Die ist in ESTOS ProCall 3.0 und Baugleiche der Benutzername. Die Struktur wird auch bei Gruppen für Gruppenleiter und Berechtigungen zwischen Gruppenmitgliedern verwendet. Dort ist die ID ein beliebiger String, da eine Zuordnung allein schon durch den Key festgelegt wurde. Das erste Bitfeld enthält folgende Information: Bit Beschreibung 0x x x Darf Präsenzzustand sehen Darf manuell Präsenzzustand ändern Darf private Termininformation sehen 0x Darf öffentliche Termininformation sehen Das zweite Bitfeld enthält Berechtigungen für den Zugriff auf die erste Leitung des Benutzers: Bit Beschreibung 0x Abgehende Rufnummern/Kontakte sehen 0x x x x Ankommende Rufnummern/Kontakte sehen Rufnummer einer Rufumleitung sehen Darf Rufumleitung setzen Darf von der Leitung Anrufe zu sich heranholen Alle anderen Bits sind reserviert und sollten beibehalten bzw. auf 0 gesetzt werden. Das dritte Bitfeld enthält Berechtigungen für den Zugriff auf die zweite Leitung des Benutzers. Diese sind äquivalent zu dem zweiten Bitfeld. extensionname Dokumentation Seite 12 von 13

13 Im Feld extensionname werden die Berechtigungen immer wie folgt formatiert (siehe dazu auch die einzelnen Value Beschreibungen): <benutzerid>;0x<erstesfeld>;0x<zweitesfeld>;0x<drittesfeld> -fine extensionname Dokumentation Seite 13 von 13