PAM_AUTHENTICATE(3)

명칭
pam_authenticate - 유저의 인증

서식
#include <security/pam_appl.h>

int pam_authenticate(pam_handle_t *pamh, int flags);

해설
pam_authenticate
이 함수를 사용하면(자), 신청 유저를 인증할 수 있습니다. 이 함수는, PAM 그리고 인증 모듈에 다이나믹하게 링크 되고 있어 이 인증 모듈이 인증을 행합니다. 어플리케이션이 인증의 본질에 관련될 것은 없습니다.
인증이 문제 없게 종료하면(자), 인증된 유저의 이름 하지만 PAM 아이템 PAM_USER 에 들어갑니다. 이 아이템은, pam_get_item(3) (을)를 호출해 취득할 수 있습니다.
어플리케이션 개발자는, 인증 모듈이 대화 메카니즘 ( pam_start(3) 참조) 그리고 유저에게 유저명을 입력시키는 일이 있는 것에 주의할 필요가 있습니다. 이 경우는, 유저 prompt string를 PAM_USER_PROMPT 아이템 ( pam_set_item(3) 참조) 그리고 설정할 수 있습니다.

반환값
문제가 없는 경우는 PAM_SUCCESS 하지만 되돌려집니다. 그 외의 값이 되돌려졌을 경우는, 인증으로 문제가 발생했다고 보여 이전에 호출했다 pam_fail_delay(3) 그리고 지정된 값만 지연 하지만 발생합니다. 특히 주의가 필요한 에러는 이하대로입니다.

PAM_ABORT
    어플리케이션을 곧바로 종료할 필요가 있습니다. 물론 최초로 pam_end(3) (을)를 호출해 주세요.

PAM_MAXTRIES
    어플리케이션이 유저의 인증을 몇번이나 반복하고 있습니다. 인증을 멈추어 주세요.

에러
pam_strerror(3) 그리고 텍스트로 변환할 수 있습니다.

준거
DCE-RFC 86.0, October 1995.

버그

발견되고 있지 않습니다.

관련 항목
pam_start(3), pam_get_item(3), pam_fail_delay(3), pam_strerror(3) 시스템관리책임자 , 모듈개발자 , 어플리케이션개발자 용무의 PAM 가이드도 참조해 주세요.