asc-users

asc を使ったチームメンバーと招待の管理

App Store Connect チームを管理します。メンバーの一覧表示、ロールの割り当て、アクセス権の取り消し、保留中の招待の管理ができます。ディレクトリとの連携や、アクセス権管理ワークフローの自動化を想定して設計されています。

認証

asc auth login --key-id <id> --issuer-id <id> --private-key-path ~/.asc/AuthKey.p8

CAEOAS — アフォーダンスが次のステップを案内します

すべての JSON レスポンスには、IDが入力済みのすぐに実行できるコマンド "affordances" が含まれます。

TeamMember のアフォーダンス：

{
  "id": "u-abc123",
  "username": "[email protected]",
  "roles": ["DEVELOPER", "APP_MANAGER"],
  "affordances": {
    "remove":      "asc users remove --user-id u-abc123",
    "updateRoles": "asc users update --user-id u-abc123 --role DEVELOPER --role APP_MANAGER"
  }
}

UserInvitationRecord のアフォーダンス：

{
  "id": "inv-xyz789",
  "email": "[email protected]",
  "roles": ["DEVELOPER"],
  "affordances": {
    "cancel": "asc user-invitations cancel --invitation-id inv-xyz789"
  }
}

利用可能なロール

--role には大文字の値を使用します。

ADMIN · FINANCE · ACCOUNT_HOLDER · SALES · MARKETING · APP_MANAGER · DEVELOPER · ACCESS_TO_REPORTS · CUSTOMER_SUPPORT · CREATE_APPS · CLOUD_MANAGED_DEVELOPER_ID · CLOUD_MANAGED_APP_DISTRIBUTION · GENERATE_INDIVIDUAL_KEYS

一般的なワークフロー

退職する従業員のアクセス権を解除する

DEPARTED_EMAIL="[email protected]"

# Check for an active team member
USER_ID=$(asc users list | jq -r --arg e "$DEPARTED_EMAIL" \
  '.data[] | select(.username == $e) | .id')

if [ -n "$USER_ID" ]; then
  asc users remove --user-id "$USER_ID"
  echo "Access revoked."
else
  # Check for a pending invitation that hasn't been accepted yet
  INV_ID=$(asc user-invitations list | jq -r --arg e "$DEPARTED_EMAIL" \
    '.data[] | select(.email == $e) | .id')
  [ -n "$INV_ID" ] && asc user-invitations cancel --invitation-id "$INV_ID"
fi

新しい開発者をオンボーディングする

asc user-invitations invite \
  --email [email protected] \
  --first-name Alex \
  --last-name Smith \
  --role DEVELOPER

開発者を App Manager に昇格させる

# Get the user's ID first
USER_ID=$(asc users list | jq -r '.data[] | select(.username == "[email protected]") | .id')

# Update replaces all roles — include every role you want them to keep
asc users update --user-id "$USER_ID" --role APP_MANAGER --role DEVELOPER

監査：すべての管理者を一覧表示する

asc users list --role ADMIN --output table

出力フラグ

--pretty          # Pretty-print JSON
--output table    # Aligned table
--output markdown # Markdown table

コマンドの詳細

すべてのフラグ、フィルター、使用例については、commands.md を参照してください。