호스팅 로그인

Fóir가 사용자가 로그인하는 페이지를 호스팅합니다. 페이지에는 프로젝트의 이름, 로고, 색상이 적용되며, 확인한 로그인 도메인에서 제공할 수도 있습니다.

페이지가 제공하는 것

페이지에는 설정한 각 아이덴티티 공급자 하나당 버튼 하나, 그리고 비밀번호 탭과 이메일 코드 탭이 표시됩니다. 비밀번호 로그인은 기본적으로 켜져 있습니다. 여섯 자리 이메일 코드는 프로젝트 설정에서 customerOtpEnabled를 켜기 전까지 꺼져 있습니다. (문서에서는 여러분의 사용자를 "고객"이라고 부릅니다.)

로그인용으로 등록하는 각 애플리케이션(문서에서는 "relying party"라고 부릅니다)은 자신에 한해 방법이나 공급자를 숨길 수 있습니다. 프로젝트가 허용하는 범위를 좁힐 수는 있지만 넓힐 수는 없습니다.

도메인과 브랜딩

페이지의 기본 주소는 auth.foir.io 도메인이며, 로그인 앱에 로그인 도메인 하나를 등록하고 DNS 레코드 두 개로 확인하면 그 도메인에서 제공됩니다. 이름, 로고, 기본 색상은 프로젝트에 속하므로 프로젝트의 모든 앱이 같은 모습을 공유합니다. 조직 단위로 이를 덮어쓸 수 있으며, 페이지도 그에 따릅니다.

새 계정과 비밀번호 재설정

호스팅 페이지에서는 아무도 쓴 적 없는 주소로 보낸 코드를 입력하거나 공급자로 처음 로그인하면 새 계정이 만들어집니다. 비밀번호로 가입하는 것은 customerRegister 뮤테이션이고, 비밀번호 재설정은 뮤테이션 한 쌍이며, 모두 여러분의 인터페이스에서 호출합니다.

누가 가입할 수 있는지는 프로젝트 설정이 결정합니다: 누구나, 초대받은 사람만, 대기자 명단, 또는 아무도 안 됨. 기존 사용자는 언제나 로그인할 수 있습니다.

토큰과 세션

로그인은 PKCE를 사용하는 OAuth 2.1 인가 코드 흐름입니다. 15분짜리 액세스 토큰과 사용할 때마다 교체되는 30일짜리 리프레시 토큰을 반환합니다. 이미 교체된 토큰을 다시 사용하면 해당 계열 전체가 해지됩니다.

앱과 등록 가능 도메인을 공유하는 확인된 로그인 도메인에서는 Fóir가 세션 쿠키를 설정하고, 앱이 이를 액세스 토큰으로 교환하므로 브라우저에 토큰이 저장되지 않습니다. 이 세션은 30일 동안 사용하지 않거나 첫 로그인 후 90일이 지나면 종료되며, 둘 다 프로젝트별로 설정할 수 있습니다.

자세한 내용

Fóir로 로그인 가이드는 로그인 앱 등록, 로그인을 시작하고 끝내는 두 뮤테이션, 토큰 갱신을 다룹니다.