macOS Setup Assistant Guide for AirTag API Setup

About Our Infrastructure

At AirPinpoint, we are committed to providing a reliable and compliant service. To ensure this:

• We run all our services on genuine Apple hardware. This approach allows us to comply with Apple's Terms of Service.
• Our use of official Apple devices and software maintains the security and legality of our API.
• We NEVER store any iCloud credentials in any way, shape, or form. Your Apple ID and password are used solely for authentication with Apple's services and are not retained or accessible by our systems.
• Accessing the Find My network is subject to Apple's terms of service. We reccomend you use a dedicated Apple ID for your devices.

Background

Before we dive into the setup process, it's crucial to understand the importance of iCloud credentials in AirTag API development. Our API interacts with Apple's Find My network to provide location data for AirTags. However, we want to emphasize a critical point:

Important: We NEVER store any iCloud credentials in any way, shape, or form. Your Apple ID and password are used solely for authentication with Apple's services and are not retained or accessible by our systems.

This approach ensures the highest level of security and privacy for our developers and end-users. The iCloud sign-in process described below is performed on your local development machine and is a necessary step to enable AirTag functionality.

Note: By creating an account with us and using our AirTag API, you agree to our Terms of Service and Privacy Policy. Please review these documents carefully before proceeding.

Navigating the Setup Assistant

When setting up a new user account on macOS for AirTag API development, you'll encounter the Setup Assistant. This guide focuses on the crucial iCloud sign-in step and how to quickly navigate through other steps.

For most steps in the Setup Assistant, you can click "Set Up Later" or equivalent options to proceed quickly. The only step we'll focus on is the iCloud sign-in.

Accessibility and other initial steps: Click "Not Now" or "Set Up Later" (not relevant) Data & Privacy: Click "Continue"

Sign In with Your Apple ID

This is the most crucial step for our AirTag API setup:

1. We strongly recommend using a dedicated dummy iCloud account for your development devices. Create a new Apple ID if you don't have one for this purpose.
2. Enter your Apple ID and password.

• You may be asked to complete a 2FA challenge. If so, enter the code from your iOS device.
• Tip: Apple 2FA may hang on the "Verifying" step. If this happens, click "Didn't get a code?" and you should see a code in your iOS notifications. Tip: Apple 2FA may hang on the "Verifying" step. If this happens, click "Didn't get a code?" to trigger a new notification, that goes to SMS instead

3. Agree to the terms and conditions.

Important: Using a separate account helps keep your personal and development environments isolated, which is crucial for testing and development.

Skipping Through Other Steps

You'll need to get all the way through until you are inside a MacOS instance. For the remaining steps, continue to choose "Set Up Later" or "Skip" options. These do not matter for our setup:

Screen Time: Choose "Set Up Later"

Choose Your Look: Select any option

Once you get to the signed in MacOS page, you are done! Close the window and return to the AirPinpoint dashboard. After a few seconds, you should see your devices connected to your account.

Troubleshooting

Stuck on Verifying?

• Tip: Apple 2FA may hang on the "Verifying" step. If this happens, click "Didn't get a code?" to trigger a new notification, that goes to SMS instead.

Not seeing your devices?

After successfully logging into the macOS instance, you may need to enable "Passwords and Keychain" in the iCloud settings:

1. Click on the Apple menu in the top-left corner of the screen.
2. Select "System Preferences" (or "System Settings" in newer versions).
3. Click on your Apple ID at the top of the preferences window.
4. In the sidebar, click on "iCloud".
5. Scroll down and ensure that "Passwords and Keychain" is checked.

Enabling this option ensures that your AirTag data can be properly synced and accessed by our API.

Need to access your MacOS instance again?

Contact us at support@airpinpoint.io and we will help you out!

Next Steps

After completing the Setup Assistant, you'll be ready to use AirPinpoint and track your airtags and apple devices with our api. Refer to our Getting Started guide for the next steps in setting up your development environment.