Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://github.com/hCaptcha/HCaptcha-ios-sdk below:

hCaptcha/HCaptcha-ios-sdk: HCaptcha SDK for iOS

• Installation
  • Cocoapods
  • Carthage
  • SPM
• Requirements
• Pre-requisites
• Examples
• Use cases
  • Setting the host override (optional)
  • Change widget theme
  • Alternate endpoint (optional)
  • More params for Enterprise (optional)
  • Enabling the visible checkbox flow
  • Using landscape instead of portrait orientation
  • SDK Events
  • Token expiration
  • Disable new token fetch on expiry
• Compiled size
• Known issues
• License
• Troubleshooting

Add hCaptcha to your project. This library automatically handles hCaptcha's events and returns a validation token, presenting the challenge via a modal if needed.

To secure your application, you need to send the token received here to your backend for server-side validation via the api.hcaptcha.com/siteverify endpoint.

HCaptcha is available through CocoaPods and packaged for Carthage and SPM (Swift Package Manager).

To install it, simply add the following line to your dependencies file:

pod "HCaptcha"
# or
pod "HCaptcha/RxSwift"

github "hCaptcha/HCaptcha-ios-sdk"

Carthage will create two different frameworks named HCaptcha and HCaptcha_RxSwift, the latter containing the RxSwift extension for the HCaptcha framework.

Known issues:

• Carthage doesn't support prebuilt zips for xcframework so use --no-use-binaries - Carthage/Carthage#3130
• Carthage has a RxSwift build issue, also avoidable via --no-use-binaries - Carthage/Carthage#3243

Standard SPM formula: uses Package.swift

Once you have the hCaptcha apiKey (also referred to as sitekey, which can be obtained at https://dashboard.hcaptcha.com/sites),

the hCaptcha apiKey can be specified in Info.plist keys or can be passed as parameters when instantiating HCaptcha().

For the Info.plist configuration, add HCaptchaKey (sitekey) and HCaptchaDomain (with a protocol, i.e. https://) to your Info.plist.

• HCaptchaKey is your hCaptcha sitekey.
• HCaptchaDomain should be a string like https://www.your.com

If you prefer to keep the information out of the Info.plist, you can instead use:

let hcaptcha = try? HCaptcha(
    apiKey: "YOUR_HCAPTCHA_KEY", 
    baseURL: URL(string: "YOUR_HCAPTCHA_DOMAIN")!
)

...

Notes:

• in most cases baseURL can be http://localhost. This value is mainly used for your convenience in analytics.
• baseURL should match HCaptchaDomain if specified; it controls the URI used to initialize the hCaptcha session. Example: https://www.your.com

If you are looking for a complete example please check links below:

• UIKit Example
• SwiftUI Example
• RxSwift Example
• SwiftUI Passive Example
• Objective-C Example

By default, Locale.current is used to automatically set the language for the SDK, but this behavior can be changed by explicitly passing the locale parameter to HCaptcha:

let hcaptcha = try? HCaptcha(
    ...
    locale: Locale(identifier: "zh-CN"),
    ...
)

...

Since this SDK uses local resources, you may want to set a host override for better tracking and enforcement of siteverify parameters.

You can achieve this by passing the extra param host:

let hcaptcha = try? HCaptcha(
    ...
    host: "your-domain.com",
    ...
)

...

Note: this should be the bare host, i.e. not including a protocol prefix like https://.

The SDK supports three built-in themes: light, dark, and contrast

let hcaptcha = try? HCaptcha(
    ...
    theme: "dark", // "light" or "contrast"
    ...
)

...

For Enterprise sitekeys we also support custom themes via the customTheme parameter, described below.

If you are an Enterprise user with first-party hosting access, you can use your own endpoint (i.e. verify.your.com).

You can then enable it in your code:

let hcaptcha = try? HCaptcha(
    ...
    endpoint: URL("https://custom.endpoint")!,
    ...
)

...

Enterprise params like:

• rqdata (string)
• reportapi (string)
• assethost (string)
• imghost (string)
• sentry (bool)
• customTheme (string representation of JS Object or JSON; see Enterprise docs)

Can be passed via HCaptcha(...)

Please see the hCaptcha Enterprise documentation for more details.

This iOS SDK assumes by default that you want an "invisible" checkbox, i.e. that triggering the hCaptcha flow from within your app should either return a token or show the user a challenge directly. (Note: "invisible" refers to the checkbox. If you want no or few visual challenges, choose Passive or 99.9% Passive as the behavior type for the sitekey in the hCaptcha dashboard.)

If you instead want the classic "normal" or "compact" checkbox behavior of showing a checkbox to tick and then either closing or showing a challenge, you can pass size to the HCaptcha initializer.

let hcaptcha = try? HCaptcha(size: .compact)

And you will now get the desired behavior.

The orientation argument can be set either .portrait or .landscape orientation to adjust challenge modal behavior.

let hcaptcha = try? HCaptcha(orientation: .landscape)

By default, orientation is portrait and does not reflow.

However, if you have an app used exclusively in landscape mode (e.g. a game) then you can also switch the challenge UI to match this design choice.

This SDK allows you to receive interaction events, for your analytics via the onEvent method. At the moment the SDK supports:

• open fires when hCaptcha is opened and a challenge is visible to an app user
• expired fires when the passcode response expires and the user must re-verify
• challengeExpired fires when the user display of a challenge times out with no answer
• close fires when the user dismisses a challenge.
• error fires when an internal error happens during challenge verification, for example a network error. Details about the error will be provided by the data param, as in the example below. Note: This event is not intended for error handling, but only for analytics purposes. For error handling please see the validate API call docs.

You can check the implementation details in:

• UIKit Example
• SwiftUI Example

Each emitted token has an expiration time. Once this time is reached, you will receive a .sessionTimeout error or an .expired event in the onEvent closure, if it is set.

However, this error/event will not be emitted in the following cases:

• HCaptchaResult.dematerialize() is called; in this case, the token is considered consumed.
• HCaptcha.stop() is called; in this case, the SDK stops all processing, and no errors or events will be emitted.

Note that Enterprise customers have additional options: please contact support for guidance if necessary.

By default the SDK will automatically fetch a new token upon expiry once you have requested a token via validate. This behavior can be adjusted by passing resetOnError: false to the validate call:

hcaptcha.validate(on: view, resetOnError: false) { result in
       ...
   }

HCaptcha pod size: 140 KB as of Jan 2024. You can always see the latest number in the CI logs by searching for the "pod size" string.

• WebView crashes on Simulator iOS 14.x (arm64) but not on real devices. More details

HCaptcha is available under the MIT license. See the LICENSE file for more info.

Q. I'm getting a "Could not load embedded HTML" exception. What does this mean?

A. Most likely you have not included an asset in your build. Please double-check assets, and see the example app for more details.

Q. I'm getting "xcconfig: unable to open file" after upgrading the SDK. (Or changing SDK and running Example app.)

A. In your app or the Example app dir, run pod deintegrate && pod install to refresh paths.

Q: The challenge modal is displayed, but I can't interact with it. How do I fix this?

A: There are several ways this can happen:

• Your app called UIApplication.shared.beginIgnoringInteractionEvents(), which prevents any user interaction, before calling the execute method of the SDK. Make sure to call UIApplication.shared.endIgnoringInteractionEvents() to re-enable interaction before executing the SDK token request if you use this method.

• You may have unintentionally added a transparent overlay over the SDK's view layer. This can be checked with the view debugger

Originally forked from fjcaetano's ReCaptcha IOS SDK, licensed under MIT.

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4