Paling penting. Integrasi dengan layanan eksternal

Memilih pengganti yang digunakan oleh sistem pesan kami, saya menemukan deskripsi Mattermost, dan memutuskan untuk mencobanya. Salah satu keuntungan dari sistem yang dijelaskan adalah integrasi sederhana dengan layanan pihak ketiga, yang disebut "kait" (kait keluar dan masuk). Itu tentang mengatur interaksi melalui kait dengan sistem eksternal dan artikel ini akan (dalam kasus khusus kami, ini adalah zabbix dan glpi).

Bagian Satu Integrasi dengan GLPI

Karena kami, dalam pekerjaan kami, menggunakan GLPI untuk menghitung peralatan, perangkat lunak, koneksi, pendaftaran panggilan dukungan teknis, akan logis untuk mengatur kemungkinan bagi pengguna untuk mengirim aplikasi ke TP dari yang paling penting.

API

GLPI memiliki http rest api untuk integrasi dengan layanan eksternal. Dokumentasi untuk itu tersedia di sistem yang diinstal di tautan http: //glpi/apirest.php/#glossary (di mana "glpi" adalah alamat server Anda).

Setelah berpikir sedikit tentang tugas, diputuskan untuk mengimplementasikan algoritma pertukaran pada php, mendukung solusi ini adalah fakta bahwa php sudah diinstal dalam sistem dan skrip secara organik dimasukkan ke dalam glpi dan tersedia di http: //glpi/mm.php . Hasilnya adalah semacam "proxy" yang menerima permintaan dari mattermost, mengonversi ke format yang diinginkan dan mengirimkan GLPI. Semua permintaan http dikirim dalam format JSON.

Prosedur kerja terdiri dari 5 bagian:

1. Menerima permintaan dari yang paling penting
2. Inisialisasi sesi di glpi
3. Mengambil data dari permintaan
4. Mengirim data ke glpi
5. Sesi penutup

Sebelum melanjutkan dengan uraian kode skrip, kami akan melakukan pekerjaan persiapan baik dalam hal paling penting maupun di gpi.

GLPI

1. Mari kita buat pengguna helpdesk, atas permintaan yang akan dibuat, dan masuk ke pengaturan pengguna ini, kami akan menghasilkan token:
   
   Yang dilingkari merah akan menjadi user_token.
2. Di pengaturan sistem, Anda perlu menambahkan klien untuk berinteraksi dengan API. Untuk melakukan ini, buka "Pengaturan" -> "Umum" -> "API" dan klik tombol "Tambah Klien", tambahkan catatan dan hasilkan token (app_token)

1. Untuk mengidentifikasi sumber permintaan dalam sistem, tambahkan entri ke direktori "Sumber permintaan" dan masuk ke entri yang baru saja ditambahkan, ingat idnya (dilingkari merah)
   

Ini menyelesaikan pengaturan API di GLPI.

Paling penting

Di menu klien Mattermost, buka "Inegration" -> "Outhooks Webshooks" klik "Tambah" dan tambahkan entri. Di layar, saya menekankan bidang yang signifikan. Di sini kita harus melakukan penyimpangan: pada intinya, "pemicu" untuk memulai prosedur pengiriman permintaan adalah kata atau frasa, yang, yang ditunjukkan pada awal pesan, sebenarnya memulai proses. Dalam kasus kami, kata pemicunya adalah "112" (di sini ada hubungan langsung dengan Kementerian Keadaan Darurat).

Nama pengguna default dan tautan ke avatar dapat ditambahkan (atau Anda tidak dapat menambahkannya), karena parameter ini akan ditransfer dalam permintaan. Tetapi agar hal terpenting untuk dapat memproses parameter ini, dalam pengaturan server Anda perlu mengubah beberapa opsi dalam file /opt/mattermost/config/config.json

"EnablePostUsernameOverride": true, "EnablePostIconOverride": true, 

Ini menyelesaikan pengaturan. Saatnya beralih ke menulis kode. Script disalin ke direktori root dengan file glpi, dalam kasus saya ini adalah /var/www/html/glpi/mm.php

  <?php # GLPI     $app_token = '7uizyyildM71x84j1UxeABXTuCHdPoLRW45Tx2wG'; $user_app_token ='dZdCqc10Xhb1TxCT4OsXp8qqDSEqILASf2wZot0w'; #    (  ,    ) $requesttypes_id = '7'; #    GLPI (1 - , 2 - ) $type = '1'; #      $postData = file_get_contents('php://input'); $data = json_decode($postData, true); #  json  MatterMost.       #         #$message_text = $data["text"]; #$user_name = $data["user_name"]; #$user_id = $data["user_id"]; #$channel_name = $data["channel_name"]; #$channel_id = $data["channel_id"]; #$team_domain = $data["team_domain"]; #$team_id = $data["team_id"]; #$post_id = $data["post_id"]; #  "112"  ,    4 . $message_text = substr($data["text"],4); #   POST ,      mattermost #HTTP/1.1 200 OK header('Content-Type: application/json'); $reply = array( 'response_type' => 'comment', 'text'=> '      ' ); echo json_encode($reply); #     glpi #        #         if( $curl = curl_init() ) { curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'Authorization: user_token '.$user_app_token, 'App-Token: '.$app_token)); curl_setopt($curl, CURLOPT_URL, 'http://glpi/apirest.php/initSession'); curl_setopt($curl, CURLOPT_POST, true); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); $out = curl_exec($curl); $session = json_decode($out, true); $session_token = $session["session_token"]; #echo $session_token; curl_close($curl); } #       $json = array( 'input'=> array( 'name'=>'  '.$data["user_name"], 'requesttypes_id'=>$requesttypes_id, 'content'=>$message_text, 'type'=>$type ) ); #   if( $curl = curl_init() ) { curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'App-Token: '.$app_token, 'Session-token: '.$session_token)); curl_setopt($curl, CURLOPT_URL, 'http://glpi/apirest.php/Ticket'); curl_setopt($curl, CURLOPT_POST, true); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($json)); $out = curl_exec($curl); curl_close($curl); } #   if( $curl = curl_init() ) { curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'App-Token: '.$app_token, 'Session-token: '.$session_token)); curl_setopt($curl, CURLOPT_URL, 'http://glpi/apirest.php/killSession'); curl_setopt($curl, CURLOPT_POST, false); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); $out = curl_exec($curl); curl_close($curl); } ?> 

Hasil skrip ini akan menjadi permintaan tambahan dalam sistem pendaftaran insiden di GLPI. Dalam gambar, terlihat seperti ini:

Kami menulis pesan paling penting:

Kami pergi ke GLPI "Dukungan" -> "Aplikasi" dan pesan baru akan muncul dalam daftar:

Dengan mengklik tajuk pesan, informasi yang lebih detail akan terbuka (bidang yang nilainya ditransmisikan dalam skrip dilingkari merah)

Pada pengaturan ini, mengirim pesan ke GLPI dari Mattermost dapat dianggap selesai. Setelah bekerja sedikit pada kode, tidak ada yang akan mencegah Anda menerapkan perubahan dalam jenis permintaan (insiden atau permintaan).