Mac Appの公証に関する最新情報

公証がmacOSと連携することにより、App Store以外でもMacのソフトウェアが安全にダウンロードできるようになります。altoolからnotarytoolへの移行の必要性についてと、Xcode GUIを使用して、Appを認証する際の全体的なパフォーマンスを向上させる方法について解説します。また、インターネット接続された任意のマシンで公証サービスとやり取りを行う際のAPIについても紹介します。

リソース

関連ビデオ

WWDC23

WWDC22

Developer Modeについて

WWDC21

WWDC19

Notarization（認証）について

ダウンロード

♪ メロウなヒップホップ音楽 ♪ ♪ こんにちは　Johnathanです macOSのデベロッパは Appを提出して公証を受けることで悪意のあるソフトウェアからユーザーを保護できます昨年私たちは notarytool CLIやコマンドラインインターフェイスを使うことでより迅速でシンプルな公証を可能にしました今年はパフォーマンスと柔軟性を維持しながら公証サービスとのやり取りを大きく改善する変更を行いますこのセッションでは主に 3つの話題を取り上げますまず公証に使用するツールを altoolから notarytoolへ移行する重要な期限について確認します次に Xcode 14で notarytoolの迅速さを実現する連携の改善について説明します最後に公証サービスとやり取りを行う柔軟な新しいサービスである REST APIについて説明しますこれを使用すると Appの提出状況の確認レビューが可能になります

昨年私たちは altoolに代わり公証を行う notarytoolを導入しました動画の後半では Xcode 14における新しいバックエンドへの移行について説明します altoolとXcode_13を新たな公証システムに移行する道筋が整いましたので古い公証方式は 2023年の秋に終了します altoolからnotarytoolへの移行については昨年発表した「より高速でシンプルな Mac Appの公証」をご覧ください具体的な内容ですが Xcode 13にバンドルされているものも含め notarytool CLIは 2023年秋移行も動作し続ける予定ですですがいつもの通り改善と修正のためにもアップデートをおすすめします Xcode 13 UIを使用した公証サービスへのアップロードは期限後に機能を終了します Xcode 14でのパフォーマンス向上については後ほど説明しますがワークフローはほとんど変わりません最後に altoolでの公証は 2023年秋にすべての機能を停止します notarytoolへの移行については昨年のWWDCでのプレゼンをご覧ください次に Xcode 14での公証の変更点について説明します Xcodeに組み込まれた公証サポートにおいて昨年導入した notarytool CLIと同じ信頼性の高いバックエンドを使用するように移行しましたこれにより昨年発表した notarytoolと同じくおよそ4倍のパフォーマンス向上を Xcode 14でも実現出来ましたその最大の利点はプロジェクトの設定やワークフローの変更なしにパフォーマンス向上を実現できることですそして最後のトピックですが新サービスである公証用の REST APIを発表しますこの新サービスによりさらに多くの場所でより柔軟に公証サービスを利用可能になりますいくつかの重要な概念の説明としてはこの新APIは公証サービスでのより柔軟なインターフェイスの提供を可能にします JSONベースのサービスとしてほとんどの言語で簡単に統合できますこのAPIを使えば macOSが実行されていない継続的インテグレーションサーバーからでもインターネット接続があればどこからでも提出物のアップロードが可能ですさらにこのAPIでは提出物の履歴や過去の提出物の内容の取得など公証サービスとのその他のやり取りもサポートされています REST API導入の目的はより多くのプラットフォームからの公証用ソフトウェアの提出をサポートし自動化されたシステムで簡単な操作を実現することですこれは現在の提出方法である Xcodeと notarytoolを補完し Linuxベースの継続的インテグレーションなどでの使用を想定しています例えばデプロイメントパイプラインの一環として Appの配信前に公証を受けたいと考えてみますこの新APIと基本的なスクリプトを使えば簡単にプロセスの自動化が可能になります本題に入る前に重要なトピックである認証についてお話します他のApp Store Connect APIと同様に JSON Web Token (JWT)を使ったAPI認証が可能です認証の詳細についてや今から紹介するコードについては以下のリンクにある REST API ドキュメントをご覧くださいこれらのスニペットではトークン変数として有効なJWTが関数に渡されていると仮定しますでは Pythonで公証用ファイルを提出する例を見てみましょうこの基本的な流れは他のプログラミング言語でも利用可能です公証用ファイルのアップロードには主に2つのステップがありますまずファイルをアップロードする旨を公証サービスに通知しますここにはファイル名や SHA-256などファイルの基本情報を含めますレスポンスにはファイルのアップロードに必要な情報とパイプラインを通じて提出物を追跡する IDを含めます次に実際に Amazon S3経由で公証用ファイルをアップロードしてみますお好きな S3 SDKを用意しますこの例では boto3 ライブラリを使用しますここでは前のコールで返された一時的認証情報を使って認証を行いクライアントを作成します次にクライアントを使い最初のステップで指定されたバケットとオブジェクトにファイルをアップロードしますアップロードが完了すると公証パイプラインを通じて提出が行われますこのプロセスはほとんどの場合 15分以内に完了しますアップロード後配信前に公証システムが正常に処理を終えたことを確認する必要がありますここでは大まかに 2つのアプローチがありますまず最も簡単なのは同じAPIを通じて結果を確認する方法ですもう1つは notarytoolで導入された webhookのサポートを利用する方法ですまず APIでのやり方を見てみましょう公証用ファイルの提出状況を確認する方法は簡単ですアップロード時に受け取った提出用のIDでリクエストしますレスポンスの一部が提出物の状況です処理が終了するまで「In Progress」と表示されますその後ステータスは「Accepted」や「Invalid」など最終的な状態に移行します提出が完了すると APIを使用してこのアップロードの公証ログを取得できますこのエンドポイントの詳細については Notary REST APIのドキュメントをご覧ください次にステータスを取得する 2つ目の方法 webhookについて説明します webhookのワークフローもほぼ同じですが今回は最初のアップロードのリクエストで webhookのURLを提出することになりますフォーマットの詳細は notary REST APIのドキュメントに記載されています先ほどと同様公証サービスが提出物の内容を分析します自動分析が終了するとチケットが作成され最終ステータスが保存されます完了すると公証サービスは提供された webhook URLに呼び出しを行いますこの呼び出しの内容には提出用ID チームID 当社からの呼び出しを証明する署名が含まれています通知を受け取った後に次の行動を選択できます例えば元の提出者に通知したり自動配信パイプラインを開始できます notarytoolで待つことに比べるとファイルをアップロードするシステムと公証後のアクションを自動化するシステムを切り離せます新しいREST APIによって継続的インテグレーションシステムや macOS向けソフトウェアを構築するツールとの統合の扉が開かれます再度まとめますと Xcode 14 notarytool またはREST APIへの移行期限は2023年の秋になっていますもしデプロイメントパイプラインで notarytoolをお使いでなければ公証REST APIを使って自動化を始める良い機会だと思いますドキュメントへのリンクは下にありますありがとうございました残りのWWDC22もお楽しみください ♪

4:53 - REST API: upload file for notarization

# Upload file for notarization

def upload_file(token, filepath, sha256):
    data = { "sha256": sha256, "submissionName": os.path.basename(filepath) }
    resp = requests.post(
       "https://appstoreconnect.apple.com/notary/v2/submissions",
        json=data,
        headers={"Authorization": "Bearer " + token})

    output = resp.json()
    aws_info = output["data"]["attributes"]
    submission_id = output["data"]["id"] 

    client = boto3.client(
        "s3",  
        aws_access_key_id=aws_info["awsAccessKeyId"],
        aws_secret_access_key=aws_info["awsSecretAccessKey"],
        aws_session_token=aws_info["awsSessionToken"])
    client.upload_file(filepath, aws_info["bucket"], aws_info["object"])

6:12 - REST API: wait for completion

# Wait for completion

def watch_upload(submission_id, token):
    while True:
        resp = requests.get(
            "https://appstoreconnect.apple.com/notary/v2/submissions/" + submission_id, 
            headers={"Authorization": "Bearer " + token})

        output = resp.json()
        current_status = output["data"]["attributes"]["status"]
        
        if current_status != "In Progress":
            return current_status # For example: Accepted or Invalid

        time.sleep(30) # Allow time for submission to progress

特定のトピックをお探しの場合は、上にトピックを入力すると、関連するトピックにすばやく移動できます。