オープンソース
HN: Qisutu – オープンソース・セルフホスト型チケット発行・サービスデスクシステム
How HN: Qisutu – an open-source, self-hosted ticketing and service desk (github.com)
要約
Qisutuは、Perl/CGI、MariaDB/MySQL、Template Toolkitを基盤としたオープンソースのチケット発行・サービスデスクシステムです。エージェントポータル、顧客ポータル、メール処理、ナレッジベース、CMDB、レポート機能などを備え、自己ホスト型で利用できます。11言語に対応し、インストールとアップデートが容易な設計になっています。
全文翻訳
ドイツ語 | 英語 | フランス語 | イタリア語 | ポルトガル語(ブラジル) | ポルトガル語(ポルトガル) | スペイン語 | オランダ語 | ポーランド語 | チェコ語 | トルコ語
Qisutu
Qisutuは、Perl/CGI、MariaDBまたはMySQL、Template Toolkit、およびブラウザベースのユーザーインターフェースを基盤とした、新しいオープンソースチケットシステムです。
プロジェクトウェブサイト: https://qisutu.de
リリースステータス
Qisutuは、エージェントおよび顧客ポータル、メール処理、ディレクトリログイン、自動化、ナレッジベース、CMDB、レポート、REST APIを備えた、自己ホスト可能なオープンソースチケットシステムです。Qisutu 1.0.2は、本番環境での使用が承認された安定版です。したがって、Qisutuはもはや開発段階にありません。インターフェースとデータベース構造は、通常のリリースメンテナンスの一環としてさらに開発されます。必要な変更は、統合されたアップデーターと継続的に維持されるデータマイグレーションを通じて提供されます。
言語
Qisutu 1.0.2には、11の完全なインターフェース言語が含まれています: ドイツ語 (de)、英語 (en)、フランス語 (fr)、イタリア語 (it)、ブラジルポルトガル語 (pt-BR)、ヨーロッパポルトガル語 (pt-PT)、スペイン語 (es)、オランダ語 (nl)、ポーランド語 (pl)、チェコ語 (cs)、トルコ語 (tr)。
インストール
以下のコマンドをrootとして/optディレクトリで実行してください:
wget https://ftp.qisutu.de/qisutu-1.0.2.tar.gz
tar xzf qisutu-1.0.2.tar.gz
mv qisutu-1.0.2 qisutu
useradd -d /opt/qisutu -c 'Qisutu user' qisutu
usermod -G www-data qisutu
chown qisutu:www-data -R qisutu
cd /opt/qisutu
chmod +x install.sh
./install.sh
install.shは、最初に11のインターフェース言語のいずれかを尋ねます。選択はインスタンス構成に保存され、Webインストーラーはすぐにその言語で開き、Qisutuのデフォルト言語として使用します。インスタンスディレクトリの名前は、技術的なインスタンス値を直接決定します。/opt/qisutuからインスタンスqisutuが作成されます。追加のqisutu--プレフィックスは追加されません。その後、スクリプトによって出力されるアドレスを開きます。例: http://SERVER/qisutu/install.pl
次に、Webインストーラーの6つのステップに従います。
install.shは、オペレーティングシステムを検出し、必要なパッケージとPerlモジュールをインストールし、各Qisutuインスタンス用に個別のApache統合、個別のsystemdサービス、個別のWebパス、および個別のデータベース構成を設定します。これにより、本番システムとテストシステムを同じサーバーで並行して実行できます。Webインストーラーは、各データベース、指定されたデータベースユーザー、install/sql/schema.sqlからのテーブル構造、install/sql/insert.sqlからの基本データ、および最初の管理者アカウントを作成します。ランダムに生成されたデータベースパスワードは、該当インスタンスのcore/config/QisutuConfig.pmに直接書き込まれます。詳細な指示と2つの並行インスタンスの完全な例はINSTALL.mdに記載されています。
アップデート
以下のコマンドをrootとして/optディレクトリで実行してください:
wget https://ftp.qisutu.de/qisutu-1.0.2.tar.gz
tar xzf qisutu-1.0.2.tar.gz
chown qisutu:www-data -R /opt/qisutu-1.0.2
cd /opt/qisutu-1.0.2
chmod +x update.sh
./update.sh
cd /opt
rm -R qisutu-1.0.2
rm qisutu-1.0.2.tar.gz
アップデーターはvar/install/instance.confを介してインスタンスを検出し、そのデーモンのみを停止し、メール取得をロックします。管理されているすべてのプログラムファイルを既存のインストールに直接コピーします。インスタンスファイル、Apache構成、またはsystemd構成は上書きされません。必要に応じて、データベースダンプも作成します。テーブル構造とすべての継続的に維持されるデータマイグレーションは完全にチェックされ、必要に応じて補完されます。詳細はINSTALL.mdに記載されています。
ディレクトリ構造
bin/ – CGIエントリーポイント、バックグラウンドプロセス、およびコマンドラインプログラム
core/ – 設定、モジュール、テンプレート、言語、およびシステムクラス
install/sql/schema.sql – 完全なテーブル構造
install/sql/insert.sql – 新規インストールの基本データ
scriptfiles/ – Apacheおよびsystemdテンプレート
var/static/ – フロントエンドアセットおよび組み込まれたサードパーティ製アセット
追加モジュール
Qisutuはバージョン0.0.78以降、読み取り可能なqisutu-module.jsonを持つ通常のモジュールZIPファイル用の独自のモジュールマネージャーを備えています。管理者は、管理者領域で追加モジュールをインストール、更新、アンインストールできます。実際のファイル操作は、Webプロセスから分離されたQisutuデーモンによって実行されます。カスタム管理者リンクと設定マスクは、それぞれの追加モジュールによって提供され、機密情報は暗号化して保存できます。Qisutu 1.0.2では、コアはバージョン管理された内部追加モジュールAPI 1.0も提供します。これには、再利用可能なモジュールサービス、デーモンを介して継続的に提供されるコアイベント、独自のAPI権限を持つ分離されたRESTルート、および制御されたUI挿入ポイントが含まれます。API指定のない既存のモジュールは互換性を維持します。モジュールは、必要なAPIバージョンと個々の機能を宣言できます。必要に応じて、Qisutuはインストール前に通常のコアアップデートを要求します。顧客固有のコアバリアントは生成されません。Qisutuコアには、意図的に具体的な追加モジュールは含まれていません。追加モジュールは、独立したプロジェクトとして開発され、完全な読み取り可能なソースコードを持つ通常のZIPファイルとして公開され、管理者領域からのみインストールされます。インストールプロセスとセキュリティチェックについては、MODULES.mdを参照してください。
時間追跡
エージェントは、チケット作成、記事、およびチケット変更時に、オプションで作業時間を時間と分で記録できます。各記録は、請求可能時間と請求不可能な時間の違いを区別し、管理者領域で管理されるアクティビティタイプに割り当てることができます。手動の個別の記録も可能です。時間記録は改ざん防止です。編集または削除されません。許可された修正は、必須の理由とともに元の記録をキャンセルし、リンクされた代替記録を作成します。修正権限は、新規インストールおよびアップデート時に管理者グループのみに割り当てられます。時間データは、エージェントおよび管理領域でのみ処理されます。顧客マスクおよび顧客記事には時間追跡は含まれません。
メール取得とOAuth2
管理者領域は、[メール取得]という単一のメニュー項目に受信メールアカウントをまとめます。そこにある概要には、既存のアカウントが表示され、3つのセットアップ方法が提供されます:
ユーザー名とパスワードによる標準IMAP
OAuth2/XOAUTH2によるMicrosoft 365
OAuth2によるGoogle WorkspaceまたはGmail
MicrosoftおよびGoogleアカウントは、保存後に直接プロバイダーにリダイレクトされます。Qisutuは、短命で一度だけ使用できるステータス値でOAuth2リターンをチェックし、アクセストークンとリフレッシュトークンを保存してから、IMAP接続をテストします。アカウントは、テストが成功した場合にのみアクティブ化されます。期限切れのアクセストークンは、メール取得時にリフレッシュトークンで自動的に更新されます。
インスタンス固有のQisutuデーモンは、設定されたメールボックスを5分ごとに自動的に取得します。各インスタンスは、独自のインストールディレクトリと独自の構成のみを使用します。qisutu-mail-fetch.plの追加のCronジョブは不要です。非アクティブなアカウントは、再度アクティブ化される前に、機能するIMAP/OAuth2接続に対して自動的にチェックされます。アカウントは、無効化された後にのみ完全に削除できます。その際、アクセス資格情報とOAuth2トークンが削除されます。既存のポストマスター処理ログは保持され、削除されたアカウントから切り離されます。
[SMTP設定]メニュー項目は、送信用の同じ明確に分離されたアカウントタイプを提供します: 標準SMTP、Microsoft 365、およびGoogle Workspace/Gmail。MicrosoftとGoogleは実際のOAuth2トークンとAUTH XOAUTH2を使用します。Microsoftは自動的にスコープhttps://outlook.office.com/SMTP.Sendを、Googleはスコープhttps://mail.google.com/を取得します。アクセストークンとリフレッシュトークンは