spaceship/README.md in fastlane-2.105.2 vs spaceship/README.md in fastlane-2.106.0

- old
+ new

@@ -111,11 +111,11 @@ ##### Open [AppStoreConnect.md](docs/AppStoreConnect.md) for code samples ## 2 Step Verification -When your Apple account has 2 factor verification enabled, you'll automatically be asked to verify your identity using your phone. The resulting session will be stored in `~/.fastlane/spaceship/[email]/cookie`. The session should be valid for about one month, however there is no way to test this without actually waiting for over a month. +When your Apple account has 2 factor verification enabled, you'll automatically be asked to verify your identity. If you have a trusted device configured for your account, then a code will appear on the device. If you don't have any devices configured, but have trusted a phone number, then a code will be sent to your phone. The resulting session will be stored in `~/.fastlane/spaceship/[email]/cookie`. The session should be valid for about one month, however there is no way to test this without actually waiting for over a month. ### Support for CI machines #### Web sessions @@ -130,9 +130,18 @@ ``` export FASTLANE_SESSION='---\n- !ruby/object:HTTP::Cookie\n name: DES5c148586dfd451e55afbaaa5f62418f91\n value: HSARMTKNSRVTWFla1+yO4gVPowH17VaaaxPFnUdMUegQZxqy1Ie1c2v6bM1vSOzIbuOmrl/FNenlScsd/NbF7/Lw4cpnL15jsyg0TOJwP32tC/NguPiyOaaaU+jrj4tf4uKdIywVaaaFSRVT\n domain: idmsa.apple.com\n for_domain: true\n path: "/"\n secure: true\n httponly: true\n expires: 2016-04-27 23:55:56.000000000 Z\n max_age: \n created_at: 2016-03-28 16:55:57.032086000 -07:00\n accessed_at: 2016-03-28 19:11:17.828141000 -07:00\n' ``` Copy everything from `---\n` to your CI server and provide it as environment variable named `FASTLANE_SESSION`. + +#### Bypass trusted device and use SMS for verification + +If you have a trusted device configured, Apple will not send a SMS code to your phone for your Apple account when you try to generate a web session with _fastlane_. Instead, a code will be displayed on one of your account's trusted devices. This can be problematic if you are trying to authenticate but don't have access to a trusted device. Take the following steps to circumvent the device and use SMS instead: + +- Attempt to generate a web session with `fastlane spaceauth -u [email]` and wait for security code prompt to appear +- Open a browser to [appleid.apple.com](https://appleid.apple.com) or an address that requires you to login with your Apple ID, and logout of any previous session +- Login with your Apple ID and request a code be sent to the desired phone when prompted for a security code +- Use the code sent to phone with _fastlane_ instead of with the browser #### Transporter If you want to upload builds to TestFlight/App Store Connect from your CI, you have to generate an application specific password: