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 になります)。

  1. JAVA_HOME の設定」ドキュメントに記載されているように JAVA_HOME 変数が構成されていることを確認します。
  2. Jira Anonymizer をダウンロードします。
  3. 一時ディレクトリを作成します。
  4. 一時ディレクトリにアノニマイザーを解凍します。
  5. Jira のバックアップ ZIP ファイル (例: 1970-Jan-01--0001.zip) を一時ディレクトリに解凍します。
  6. 次のコマンドでバックアップ ファイルを匿名化します。

    $ 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

    (warning) バックアップのサイズによって、JVM に追加メモリの割り当てが必要となる場合があります。これを行うには、Xmx の値を 128m のインクリメントで増やします。

    サポートされていない XML 文字が原因で Jira Anonymizer に障害が発生した場合は、アトラシアンの XML クリーンアップ ユーティリティを使用して entities.xml ファイルをクリーンアップできます。ファイルがクリーンアップされたら、Jira Anonymizer を再度実行します。

  7. 生成された匿名化済みの XML バックアップ ファイル (例: anon-entities.xml) および activeobjects.xml (Jira 4.4.x + のみ) を ZIP または tarball 形式で圧縮します。
  8. Attach that ZIP or tarball onto the support issues as raised on support.atlassian.com.
  9. これで一時ディレクトリを削除できます。
以下のスクリーンショットは、 Windows XP のコマンドプロンプトで実行した際のシンプルな例を示しています。

Windows のコマンド プロンプト。

Anonymizer に関する情報

アノニマイザーは現在、次のテキストを x に置き換えます。

  • 課題のまとめ、環境および説明。
  • コメント、作業ログ、変更ログ。
  • プロジェクトの説明。
  • ほとんどの要素の説明 (通知スキーム、権限スキーム、解決策)。
  • 添付ファイル名。
  • 「無制限テキスト」カスタムフィールド

匿名化済みのバックアップや anon-backup.xml を組織のニーズに照らし合わせて確認し、アトラシアンに送信して問題ない内容であることを確認します。

最終更新日 2021 年 7 月 1 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.