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
Depending on the size of the backup, additional memory may need to be allocated to the JVM. In order to do this, increase the value of the Xmxin increments of128m.サポートされていない 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 を組織のニーズに照らし合わせて確認し、アトラシアンに送信して問題ない内容であることを確認します。