Jira アプリケーション データの匿名化
データが提供されている場合、サポーターがインスタンスへのコピーに直接アクセスできるため、サポートリクエストを大幅に短期間で解決できることがよくあります。アトラシアンではデータの機密性により、情報の提供が困難な場合があることも理解しており、この特定のシナリオに対応する匿名化ツールを作成しました。
Jira データの匿名化
Jira のビルトイン バックアップ機能では、使用されるバージョンによって 1 または 2 XML ファイルを含む ZIP ファイルを生成します。これらのファイルは Jira のデータベースの全コンテンツのコピーであり、インスタンスの復元に使用可能な XML にエンコードされます。詳細については、Jira アプリケーション バックアップの自動化ドキュメントに記載しています。
Jira 4.4 の時点では、バックアップ機能では 2 つの XML ファイルを含む ZIP ファイルが生成されます。これらのファイルは activeobjects.xml および entities.xml です。 entities.xml のみを匿名化する必要があります。activeobjects.xml は匿名化しないでください。4.4 以前のバージョンについては、圧縮された ZIP と同じ命名規則で XML ファイルが 1 つのみ生成されます (例: 1970-Jan-01–0001.zip を展開すると 1970-Jan-01--0001.xml になります)。
- 「JAVA_HOME の設定」ドキュメントに記載されているように
JAVA_HOME変数が構成されていることを確認します。 - Jira Anonymizer をダウンロードします。
- 一時ディレクトリを作成します。
- 一時ディレクトリにアノニマイザーを解凍します。
- Jira のバックアップ ZIP ファイル (例:
1970-Jan-01--0001.zip) を一時ディレクトリに解凍します。 次のコマンドでバックアップ ファイルを匿名化します。
$ java -DentityExpansionLimit=2147480000 -DtotalEntitySizeLimit=2147480000 -Djdk.xml.totalEntitySizeLimit=2147480000 -Xmx2g -jar joost.jar <JIRA BACKUP>.xml anon.stx > <NAME OF ANONYMISED BACKUP>.xmlたとえば、これにより、Jira 4.4+ からの命名規則で JIRA バックアップを匿名化します。
$ java -DentityExpansionLimit=2147480000 -DtotalEntitySizeLimit=2147480000 -Djdk.xml.totalEntitySizeLimit=2147480000 -Xmx2g -jar joost.jar entities.xml anon.stx > anon-entities.xml
バックアップのサイズによって、JVM に追加メモリの割り当てが必要となる場合があります。これを行うには、Xmxの値を128mのインクリメントで増やします。サポートされていない XML 文字が原因で Jira Anonymizer に障害が発生した場合は、アトラシアンの XML クリーンアップ ユーティリティを使用して
entities.xmlファイルをクリーンアップできます。ファイルがクリーンアップされたら、Jira Anonymizer を再度実行します。- 生成された匿名化済みの XML バックアップ ファイル (例:
anon-entities.xml) およびactiveobjects.xml(Jira 4.4.x + のみ) を ZIP または tarball 形式で圧縮します。 - Attach that ZIP or tarball onto the support issues as raised on support.atlassian.com.
- これで一時ディレクトリを削除できます。
Anonymizer に関する情報
アノニマイザーは現在、次のテキストを x に置き換えます。
- 課題のまとめ、環境および説明。
- コメント、作業ログ、変更ログ。
- プロジェクトの説明。
- ほとんどの要素の説明 (通知スキーム、権限スキーム、解決策)。
- 添付ファイル名。
- 「無制限テキスト」カスタムフィールド
匿名化済みのバックアップや anon-backup.xml を組織のニーズに照らし合わせて確認し、アトラシアンに送信して問題ない内容であることを確認します。