사용자 & 인증 제공자 구성 파일

이 페이지의 내용

인증 공급자

구성
사용자 지정 사용자 데이터

Atlas Device Sync, Atlas Edge Server, Data API 및 HTTPS endpoints 는 더 이상 사용되지 않습니다. 자세한 내용은 지원 중단 페이지를 참조하세요.

참고

이 페이지에서는 레거시 구성 파일 형식에 대해 설명합니다. 이 정보는 더 이상 사용되지 않는 realm-cli 을 사용하는 경우에만 사용해야 합니다.

App Services CLI로 가져오거나 UI에서 내보내는 모든 구성 파일은 최신 구성 버전을 사용합니다. 현재 구성 파일 형식에 대한 자세한 내용은 앱 구성을 참조하세요.

app/
└── auth/
    ├── providers.json
    └── custom_user_data.json

인증 공급자

구성

/auth/providers.json 에서 인증 제공자 를 활성화하고 구성할 수 있습니다.

구성의 각 필드는 제공자 유형의 이름이며 해당 제공자에 대한 구성 객체를 포함합니다. 인증 제공자 구성은 공통된 구조를 공유하지만 각 제공자 유형은 고유한 구성 필드 세트를 사용합니다.

팁

특정 제공자의 구성에 대한 자세한 정보는 해당 제공자의 참고 페이지에서 확인할 수 있습니다. 모든 제공자 참고 페이지 목록은 인증 제공자.

/auth/providers.json

{
  "<Provider Name>": {
    "name": "<Provider Name>",
    "type": "<Provider Type>",
    "disabled": <Boolean>,
    "config": {
      "<Configuration Option>": "<Configuration Value>"
    },
    "secret_config": {
      "<Configuration Option>": "<Secret Name>"
    },
    "metadata_fields": [
      {
        "required": <Boolean>,
        "name": "Field Name"
      },
      ...
    ],
    "redirect_uris": ["<Application Redirect URI>", ...]
  },
  ...
}

필드	설명
`name` String	인증 제공자 의 이름입니다. 이는 항상 제공자의 `type` 과 동일합니다.
`type` String	인증 제공자 유형입니다. 유효한 옵션은 다음과 같습니다. `"anon-user"` 익명 인증의 경우. `"local-userpass"` 이메일/비밀번호 인증의 경우. `"api-key"` API 키 인증의 경우. `"custom-token"` 사용자 지정 JSON web token 인증의 경우. `"custom-function"` 사용자 지정 기능 인증의 경우. `"oauth2-google"` Google 인증의 경우. `"oauth2-facebook"` Facebook 인증의 경우. `"oauth2-apple"` Apple ID 인증의 경우.
`disabled` Boolean	`true` 인 경우 이 인증 제공자는 애플리케이션에 대해 활성화되지 않았습니다. 사용자는 비활성화된 제공자의 자격 증명을 사용하여 로그인할 수 없습니다.
`config` Document	인증 제공자와 관련된 구성 값이 포함된 문서입니다. 다음 제공자 구성에는 `config` 이 포함됩니다. 이메일/비밀번호 사용자 지정 JWT 사용자 지정 기능 Google Facebook 애플 아이디
`secret_config` Document	각 필드 이름이 제공자의 비공개 구성 필드이고 각 필드의 값이 구성 값을 저장하는 Secret 의 이름인 문서입니다. 다음 제공자 구성에는 `redirect_uris` 이 포함됩니다. 사용자 지정 JWT Google Facebook 애플 아이디
`metadata_fields` Array<Document>	각 문서가 사용자를 설명하는 메타데이터 필드를 정의하는 문서 배열입니다. 이 필드의 존재 여부와 각 메타데이터 필드 문서의 정확한 형식은 제공자 유형에 따라 다릅니다. 다음 제공자 구성에는 `metadata_fields` 이 포함됩니다. 사용자 지정 JWT Google Facebook
`redirect_uris` Array<String>	OAuth 권한 부여를 완료한 후 Atlas App Services가 사용자를 다시 리디렉션할 수 있는 URL 목록입니다. 다음 제공자 구성에는 `redirect_uris` 이 포함됩니다. Google Facebook 애플 아이디

사용자 지정 사용자 데이터

/auth/custom_user_data.json에서 앱에 대한 사용자 지정 사용자 데이터 컬렉션 을 구성할 수 있습니다.

/auth/custom_user_data.json

{
  "enabled": <Boolean>,
  "mongo_service_name": "<MongoDB Data Source Name>",
  "database_name": "<Database Name>",
  "collection_name": "<Collection Name>",
  "user_id_field": "<Field Name>",
  "on_user_creation_function_name": "<Function Name>"
}

필드 이름	설명
`enabled` Boolean	`true` 인 경우 App Services는 각 사용자를 사용자 지정 데이터가 포함된 지정된 collection의 문서와 연결합니다.
`mongo_service_name` String	사용자 지정 사용자 데이터 컬렉션이 포함된 데이터 소스 의 이름입니다.
`database_name` String	사용자 지정 사용자 데이터 컬렉션이 포함된 데이터베이스의 이름입니다.
`collection_name` String	사용자 지정 사용자 데이터가 포함된 collection의 이름입니다.
`user_id_field` String	문서에서 설명하는 애플리케이션 사용자의 사용자 ID를 포함하는 사용자 지정 사용자 데이터 문서의 필드 이름입니다.
`on_user_creation_function_name` String	사용자 생성 함수의 이름입니다.

Atlas Application Services란 무엇인가요?