방법: 기기 비밀번호 입력 요청하기

뛰어난 사용성을 유지하면서 앱의 보안을 강화하고 싶으신가요? 로컬 인증이 좋은 방법일 수 있어요. 이 문서에서는 사용자가 앱의 특정 부분에 접근하기 전에 기기 PIN, 지문 또는 Face ID를 입력하도록 요청하는 방법을 안내해 드려요.

기능 활성화하기

권한 설정에서 생체 인식 권한을 활성화해 주세요. 그렇지 않으면 이 기능이 일부만 작동하거나(Face ID 사용 불가) 예상치 못한 방식으로 작동하지 않을 수 있어요.

JavaScript 함수 사용하기

requestLocalAuthentication

이 함수를 사용해 사용자에게 인증을 요청하세요.

인증에 성공하면 이 함수는 불리언 결과가 포함된 객체를 반환해요. 인증 요청이 취소되거나 기기에서 인증을 계속할 수 없으면 문자열 오류 코드가 대신 발생해요.

<script>
    try {
        // This message will be displayed to the user along with the prompt.
        let reason = "Please authenticate to access this part of the app";

        // Returns a boolean. True if the authentication was successful, false if the authentication challenge failed.
        // If the prompt is canceled or the device cannot continue, an error string is thrown instead.
        let authenticationResult = (await requestLocalAuthentication(reason))["result"];
    }
    catch (e) {
        switch(e) {
            case "userCanceled":
                // The user canceled the prompt and didn't authenticate.
                break;
            case "authInProgress":
                // Another authentication request is already running.
                break;
            case "noCredentialsSet":
                // No biometrics, PIN, password, or pattern is configured.
                break;
            case "systemCanceled":
                // The system interrupted the authentication attempt, for example when the app gets closed.
                break;

            // All the errors below should be very rare in practice:

            case "timeout":
                // The authentication prompt timed out.
                break;
            case "uiUnavailable":
                // The system cannot show the authentication prompt right now.
                break;
            case "deviceError":
                // A device-level error prevented authentication.
                break;
            case "unknownError":
                // An unknown error occurred.
                break;
            default:
                // Any other error
                break;
        }
    }
</script>