Dirk/hermineConnectPHP
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

* 26.11.2023 -> open_conversation eingebaut

Browse Source
This commit is contained in:
NTEN\Nenninger
2023-11-26 20:34:55 +01:00
parent 6c09b9f301
commit fa1c1f7d47
2 changed files with 719 additions and 756 deletions
Download Patch File Download Diff File Expand all files Collapse all files

114
hermineConnect.php
View File

@@ -1,67 +1,7 @@
<?php
/*
/*
Nenninger N-Tools.de
Version 1.12
*20.06.2023 -> neue Parameter und devid darf keine Zeichen sondern nur Buchstaben und Zahlen enthalten
*13.09.2023 -> cookie Datei und Login.dat umbenannt
*19.09.2023 -> $_SERVER['SERVER_NAME'] wird wenn nicht da auf Hostname gesetzt
*20.09.2023 -> get_channel_messages korrigiert (limit, offset)
*26.09.2023 -> löschen von Dateien eingebaut;
*31.10.2023 -> Fehler beim speichern der Logins gefixt
hermine@THW PHPConnector
inspiriert von https://gitlab.com/aeberhardt/stashcat-api-client
curl und php >= 7.4
Funktionen:
get_last_error();
login(soll der Login gespeichert werden);
get_companies_list(); -> List der Firmen (wird beim Login erstellt)
get_conversations_list(); -> List der Konversationen (wird beim Login erstellt)
get_channels_list(); -> List der Kanäle (1. Firma) (wird beim Login erstellt)
send_message_to_conversation(id,Nachricht,optional URLs als array, optional Standort als Array);
send_message_to_channel(id,Nachricht,optional URLs als array, optional Standort als Array);
send_message_with_file_to_conversation(id,Nachricht,Dateiinhalt (max 5MB),Dateiname in Hermine,Type Bsp:'image/jpeg',Breite Standard 0,Höhe Standard 0);
send_message_with_file_to_channel(id,Nachricht,Dateiinhalt (max 5MB),Dateiname in Hermine,Type Bsp:'image/jpeg',Breite Standard 0,Höhe Standard 0);
get_channel_messages(id, $_limit=50, $_offset=0); -< array
get_conversation_messages(id,limit=50,offset=0); -< array
Beispiele:
$hermine = new hermineConnect('mailadresse','Accountpassword','Verschlüsselungskennwort');
if($hermine->login(true) !== false){
$array = $hermine->get_companies_list();
print_r($array);
$array = $hermine->get_conversations_list();
print_r($array);
$array = $hermine->get_channels_list();
print_r($array);
$file = file_get_contents('./test.jpg');
$hermine->send_message_with_file_to_channel(165562,'jpg per php',$file,'test.jpg','image/jpeg',1080,2068);
$array = $hermine->get_channel_messages(165562);
foreach($array as $msg){
echo $msg->text."\n";
}
$array = $hermine->search_user('Nennin');
}else{
//login fehlgeschlagen
print_r($hermine->get_last_error);
}
Version 1.13
*/
@@ -176,7 +116,7 @@ class UUID {
class hermineConnect{
private $VERSION = '1.12';
private $VERSION = '1.13';
private $MACHINENAME = 'default';
private $hermineServer = 'https://api.thw-messenger.de';
private $connectorID = "";
@@ -202,9 +142,6 @@ class hermineConnect{
$delimiter = '-------------' . $boundary;
foreach ($fields as $name => $content) {
/*echo "@@\n";
print_r($content);
echo "@@\n";*/
$data .= "--" . $delimiter . $eol
. 'Content-Disposition: form-data; name="' . $name . "\"".$eol.$eol
. $content . $eol
@@ -579,8 +516,7 @@ class hermineConnect{
}
}
public function _delete_files($_ids=[]){
/*file_ids=%5B8826184%5D ([8826184])*/
function _delete_files($_ids=[]){
$data = [
"file_ids" => json_encode($_ids)
];
@@ -588,14 +524,47 @@ class hermineConnect{
$response = $this->request($this->hermineServer."/file/delete",$data);
if($response !== false){
//print_r($response);
return $response->success;
}else{
return false;
}
}
/*
function _open_conversation($_members){
$conversation_key = openssl_random_pseudo_bytes(32);
$receivers = [];
//selbst immer Mitglied
$key = '';
if(openssl_private_encrypt($conversation_key,$key,$this->private_key,OPENSSL_PKCS1_PADDING) === false)
return false;
$receivers[] = ['id' => (int)$this->user_id, 'key' => base64_encode($key)];
foreach($_members as $member){
if(isset($member['id']) && isset($member['public_key'])){
if(openssl_public_encrypt($conversation_key,$key,$member['public_key'],OPENSSL_PKCS1_OAEP_PADDING ) === false)
return false;
//throw new Exception(openssl_error_string());
$receivers[] = ['id' => (int)$member['id'], 'key' => base64_encode($key)];
}
}
$data = [
"members" => json_encode($receivers)
];
$response = $this->request($this->hermineServer."/message/createEncryptedConversation",$data);
if($response !== false){
//wenn neu angelgt, muss der Key angefragt werden
if($response->conversation->unique_identifier == '' && $response->conversation->key_requested == '')
$this->request($this->hermineServer."/security/reset_content_key",["conversation_id" => $response->conversation->id]);
return $response->conversation;
}else{
return false;
}
}
/*
Öffentliche Funktionen
*/
@@ -652,7 +621,6 @@ class hermineConnect{
$this->channels = $this->get_channels($this->companies->companies[0]->id);
$this->conversations = $this->get_conversations();
if($_saveLogin){
print_r($savelogin);
$savelogin->ClientKey = $this->client_key;
$savelogin->DeviceId = $this->connectorID;
$savelogin->UserID = $this->user_id;
@@ -744,5 +712,9 @@ class hermineConnect{
public function delete_files($_ids=[]){
return $this->_delete_files($_ids);
}
public function open_conversation($_members){
return $this->_open_conversation($_members);
}
}
?>

71
readme.txt
View File

@@ -2,12 +2,13 @@
Nenninger N-Tools.de
Version 1.12
*20.06.2023 -> neue Parameter und devid darf keine Zeichen sondern nur Buchstaben und Zahlen enthalten
*13.09.2023 -> cookie Datei und Login.dat umbenannt
*19.09.2023 -> $_SERVER['SERVER_NAME'] wird wenn nicht da auf Hostname gesetzt
*20.09.2023 -> get_channel_messages korrigiert (limit, offset)
*26.09.2023 -> löschen von Dateien eingebaut;
*31.10.2023 -> Fehler beim speichern der Logins gefixt
* 20.06.2023 -> neue Parameter und devid darf keine Zeichen sondern nur Buchstaben und Zahlen enthalten
* 13.09.2023 -> cookie Datei und Login.dat umbenannt
* 19.09.2023 -> $_SERVER['SERVER_NAME'] wird wenn nicht da auf Hostname gesetzt
* 20.09.2023 -> get_channel_messages korrigiert (limit, offset)
* 26.09.2023 -> löschen von Dateien eingebaut;
* 31.10.2023 -> Fehler beim speichern der Logins gefixt
* 26.11.2023 -> open_conversation eingebaut
hermine@THW PHPConnector
inspiriert von https://gitlab.com/aeberhardt/stashcat-api-client
@@ -18,7 +19,6 @@
get_last_error();
login(soll der Login gespeichert werden);
get_companies_list(); -> List der Firmen (wird beim Login erstellt)
@@ -34,35 +34,17 @@
get_channel_messages(id, $_limit=50, $_offset=0); -< array
get_conversation_messages(id,limit=50,offset=0); -< array
get_channel_infos($_channel_id); -< array
search_user($_searchby, $_limit=50, $_offset=0); -< array
Beispiele:
list_uploaded_chat_files($_search); -< array
$hermine = new hermineConnect('mailadresse','Accountpassword','Verschlüsselungskennwort');
if($hermine->login(true) !== false){
$array = $hermine->get_companies_list();
print_r($array);
$array = $hermine->get_conversations_list();
print_r($array);
$array = $hermine->get_channels_list();
print_r($array);
delete_files($_ids=[]) -< boolean
$file = file_get_contents('./test.jpg');
$hermine->send_message_with_file_to_channel(165562,'jpg per php',$file,'test.jpg','image/jpeg',1080,2068);
open_conversation($_members) -< array
$array = $hermine->get_channel_messages(165562);
foreach($array as $msg){
echo $msg->text."\n";
}
$array = $hermine->search_user('Nennin');
}else{
//login fehlgeschlagen
print_r($hermine->get_last_error);
}
Beispiele 1:
Beispiel "Login, Chats holen, Nachricht mit Datei senden":
$hermine = new hermineConnect('mailadresse','Accountpassword','Verschlüsselungskennwort');
if($hermine->login(true) !== false){
@@ -76,26 +58,23 @@
$file = file_get_contents('./ich.jpg');
$hermine->send_message_with_file_to_channel(165562,'jpg per php',$file,'test.jpg','image/jpeg',1080,2068);
}else{
//login fehlgeschlagen
print_r($hermine->get_last_error);
}
Beispiel 2:
Beispiel "Login und Prüfen ob Mitglieder in Channels vorhanden sind":
$hermine = new hermineConnect('mailadresse','Accountpassword','Verschlüsselungskennwort');
if($hermine->login(true) !== false){
$quasselgruppe = $hermine->get_channel_infos(110266);
$content .= 'die Quasselgruppe hat '.count($quasselgruppe->members).' Mitglieder<br>Achtung Karin ist RSt!!!<br><br>';
//print_r($quasselgruppe->members);
$content .= 'die Quasselgruppe hat '.count($quasselgruppe->members).' Mitglieder';
//AnkündigungsCHannel 209674
$gruppe = $hermine->get_channel_infos(209674);
$content .= 'der Ankündigungschannel hat '.count($gruppe->members).' Mitglieder<br>Achtung Karin ist RSt!!!<br><br>';
$content .= 'der Ankündigungschannel hat '.count($gruppe->members).' Mitglieder';
$array = $hermine->search_user('(OV Alzenau)',200,0);
//print_r($array);
$content .= '(OV Alzenau) haben '.count($array).' Mitglieder im Nachnamen<br>Achtung Karin ist RSt!!!<br><table >';
$content .= '(OV Alzenau) haben '.count($array).' Mitglieder im Nachnamen<table >';
$content .= '<tr><th>Helfende</th><th>Quasselgruppe</th><th>Ankündigungs Gruppe</th></tr>';
foreach($array as $user){
$content .= '<tr style="border-bottom: solid 1px;"><td>'.$user->first_name.' '.$user->last_name;
@@ -109,10 +88,22 @@
if($uAG !== false){
$content .= 'X';
}
//$content .= print_r($uQG,true);
$content .= "</td></tr>\n";
}
}else{
//login fehlgeschlagen
print_r($hermine->get_last_error);
}
Beispiel "Login und Konversation erstellen" *wenn diese schon vorhanden ist, wird die schon vorhandene zurück gegeben*:
$hermine = new hermineConnect('mailadresse','Accountpassword','Verschlüsselungskennwort');
if($hermine->login(true) !== false){
$ret = $hermine->open_conversation([
['id'=>xxxxxxx,'public_key'=>'-----BEGIN PUBLIC KEY-----hier muss der Publickey rein (kann mit search_user geholt werden )-----END PUBLIC KEY-----'],
['id'=>xxxxxxx,'public_key'=>'-----BEGIN PUBLIC KEY-----hier muss der Publickey rein (kann mit search_user geholt werden )-----END PUBLIC KEY-----'],
...
]);
print_r($ret);
}else{
print_r($hermine->get_last_error);
}