# recaptcha-enterprise
Please note that issues filed in this repository are not an official Google
support channel and are answered on a best effort basis. For official support,
please visit:
[https://cloud.google.com/support-hub](https://cloud.google.com/support-hub).
To integrate reCAPTCHA Enterprise, please follow the instructions for
[iOS](https://cloud.google.com/recaptcha-enterprise/docs/instrument-ios-apps)
and
[Android](https://cloud.google.com/recaptcha-enterprise/docs/instrument-android-apps).
## ⚠️ Important Updates
### Upgrade your reCAPTCHA Enterprise Mobile SDK for increased protection
We have dealt with a technical issue affecting users on iOS 27 on SDK versions prior to `v18.9.0` that caused application crashes during initialization.
Applications will no longer crash, but some detection capabilities will be impacted.
To ensure the best protection for your application and your end users, upgrade your application dependency to **reCAPTCHA Enterprise Mobile SDK version 18.9.0 or higher** or higher as soon as possible.
### CocoaPods Support Ending
Please note that versions **18.9.X** will be the **final releases** of the
reCAPTCHA Enterprise Mobile SDK to support CocoaPods. Starting with the *next*
version, we will officially end CocoaPods support.
#### Why the Change?
This decision also aligns with the broader community trajectory, as CocoaPods
itself has scaled back infrastructure and shifted into maintenance mode. For
more context on the current state of CocoaPods, you can read their official
update regarding the
[CocoaPods Specs Repo](https://blog.cocoapods.org/CocoaPods-Specs-Repo/).
#### What This Means for You
* **18.9.X:** You can continue to use CocoaPods to integrate this specific
release and patches.
* **No Future CocoaPods Releases:** For the next SDK version all subsequent
updates, security patches, bug fixes, and new features will be distributed
exclusively via Swift Package Manager.
* **Existing Implementations:** Your current project will not break if it
remains on this or an older, CocoaPods-based version of the SDK. However,
you will not receive future updates until you migrate your project to SPM.
### Security Vulnerability in SDKs Below 18.4.0
A critical security vulnerability was discovered in reCAPTCHA Enterprise for
Mobile. The vulnerability has been patched in the latest SDK release. Customers
will need to update their Android application with the reCAPTCHA Enterprise for
Mobile SDK, version 18.4.0 or above. We strongly recommend you update to the
latest version as soon as possible.
### Upgrading from 18.X.X to 18.2.0 in Android
WARNING: Due to a bug described in
[Issue 52](https://github.com/GoogleCloudPlatform/recaptcha-enterprise-mobile-sdk/issues/52),
some users may experience unrecoverable errors if you have used a version of the
SDK < 18.2.0 and then upgrade to 18.2.0. Instead please upgrade directly to
18.2.1.
## Example Implementations
### Basic
The basic example applications demonstrate how to implement the reCAPTCHA
Enterprise score-based challenges in mobile applications. These implementations
demonstrate best practices with init started at app startup, retries, and
waiting for network connectivity.
### Visual
The visual example applications demonstrate how to incorporate visual challenges
into a mobile application using a webview.