엔터프라이즈 설정

조직의 요구에 맞게 기기 관리 솔루션으로 Cursor의 특정 기능을 중앙에서 관리할 수 있어. Cursor 정책을 지정하면 그 값이 사용자 기기에서 대응하는 Cursor 설정을 덮어써. ‘Extensions: Allowed’ 설정이 조직에서 관리되고 있음을 보여주는 설정 편집기. 현재 Cursor는 다음 관리자 제어 기능을 관리할 수 있는 정책을 제공해:
PolicyDescriptionCursor settingAvailable since
AllowedExtensions설치할 수 있는 확장을 제어해.extensions.allowed1.2
AllowedTeamId로그인할 수 있는 팀 ID를 제어해. 인가되지 않은 팀 ID의 사용자는 강제로 로그아웃돼.cursorAuth.allowedTeamId1.3

허용된 확장 기능 구성

extensions.allowed Cursor 설정은 설치 가능한 확장 기능을 제어해. 퍼블리셔 이름을 키로, 해당 퍼블리셔의 확장 기능 허용 여부를 나타내는 불리언 값을 가지는 JSON 객체를 받지. 예를 들어 extensions.allowed{"anysphere": true, "github": true}로 설정하면 Anysphere와 GitHub 퍼블리셔의 확장 기능이 허용되고, {"anysphere": false}로 설정하면 Anysphere 확장 기능이 차단돼. 조직 차원에서 허용할 확장 기능을 중앙에서 관리하려면 디바이스 관리 솔루션으로 AllowedExtensions 정책을 구성해. 이 정책은 사용자 디바이스의 extensions.allowed 설정을 무시하고 덮어써. 정책 값은 허용할 퍼블리셔를 정의하는 JSON 문자열이야. Cursor의 확장 기능에 대해 더 자세히 알고 싶다면 확장 기능 문서를 참고해.

허용된 팀 ID 구성하기

cursorAuth.allowedTeamId Cursor 설정은 Cursor에 로그인할 수 있는 팀 ID를 제어해. 이 설정은 액세스가 허용된 팀 ID를 콤마로 구분한 목록을 받아. 예를 들어, cursorAuth.allowedTeamId"1,3,7"로 설정하면 해당 팀 ID에 속한 사용자만 로그인할 수 있어. 허용 목록에 없는 팀 ID로 로그인을 시도하면:
  • 즉시 강제로 로그아웃돼
  • 오류 메시지가 표시돼
  • 유효한 팀 ID를 사용할 때까지 애플리케이션이 추가 인증 시도를 막아
조직 차원에서 허용된 팀 ID를 중앙에서 관리하려면, 디바이스 관리 솔루션에서 AllowedTeamId 정책을 구성해. 이 정책은 사용자 디바이스의 cursorAuth.allowedTeamId 설정을 재정의해. 정책 값은 허용된 팀 ID를 콤마로 구분한 문자열이야.

Windows의 그룹 정책

Cursor는 Windows 레지스트리 기반 그룹 정책을 지원해. 정책 정의를 설치하면 관리자는 로컬 그룹 정책 편집기로 정책 값을 관리할 수 있어. 정책을 추가하려면:
  1. AppData\Local\Programs\cursor\policies에서 ADMX와 ADML 정책 파일을 복사해.
  2. ADMX 파일은 C:\Windows\PolicyDefinitions 디렉터리에, ADML 파일은 C:\Windows\PolicyDefinitions\<your-locale>\ 디렉터리에 붙여넣어.
  3. 로컬 그룹 정책 편집기를 다시 시작해.
  4. 로컬 그룹 정책 편집기에서 적절한 정책 값을 설정해 (예: AllowedExtensions 정책에 {"anysphere": true, "github": true}).
정책은 Computer 수준과 User 수준 모두에 설정할 수 있어. 둘 다 설정되면 Computer 수준이 우선해. 정책 값이 설정되면, 그 값이 어떤 수준(기본값, 사용자, 워크스페이스 등)에서 구성된 Cursor 설정 값을 재정의해.

macOS의 구성 프로파일

구성 프로파일은 macOS 기기의 설정을 관리해. 프로파일은 사용 가능한 정책에 대응하는 키-값 쌍으로 이뤄진 XML 파일이야. 이 프로파일은 Mobile Device Management(MDM) 솔루션으로 배포하거나 수동으로 설치할 수 있어.
macOS용 예시 .mobileconfig 파일은 아래와 같아:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
	<dict>
		<key>PayloadContent</key>
		<array>
			<dict>
				<key>PayloadDisplayName</key>
				<string>Cursor</string>
				<key>PayloadIdentifier</key>
				<string>com.todesktop.230313mzl4w4u92.J6B5723A-6539-4F31-8A4E-3CC96E51F48C</string>
				<key>PayloadType</key>
				<string>com.todesktop.230313mzl4w4u92</string>
				<key>PayloadUUID</key>
				<string>J6B5723A-6539-4F31-8A4E-3CC96E51F48C</string>
				<key>PayloadVersion</key>
				<integer>1</integer>
				<key>AllowedExtensions</key>
				<string>{"anysphere":true}</string>
				<key>AllowedTeamId</key>
				<string>1,2</string>
			</dict>
		</array>
		<key>PayloadDescription</key>
		<string>This profile manages Cursor.</string>
		<key>PayloadDisplayName</key>
		<string>Cursor</string>
		<key>PayloadIdentifier</key>
		<string>com.todesktop.230313mzl4w4u92</string>
		<key>PayloadOrganization</key>
		<string>Anysphere</string>
		<key>PayloadType</key>
		<string>Configuration</string>
		<key>PayloadUUID</key>
		<string>F2C1A7B3-9D4E-4B2C-8E1F-7A6C5D4B3E2F</string>
		<key>PayloadVersion</key>
		<integer>1</integer>
		<key>TargetDeviceType</key>
		<integer>5</integer>
	</dict>
</plist>

문자열 정책

아래 예시는 AllowedExtensions 정책 구성을 보여줘. 샘플 파일에서 이 정책 값은 비어 있는 상태로 시작해(허용된 확장자 없음).
<key>허용된 확장자</key>
<string></string>
<string> 태그 사이에 정책을 정의하는 적절한 JSON 문자열을 추가해.
<key>AllowedExtensions</key>
<string>{"anysphere": true, "github": true}</string>
AllowedTeamId 정책에는 팀 ID를 쉼표로 구분해 나열해줘:
<key>AllowedTeamId</key>
<string>1,3,7</string>
중요: 제공된 .mobileconfig 파일은 해당 버전의 Cursor에서 사용 가능한 모든 정책을 초기화해. 필요 없는 정책은 삭제해. 샘플 .mobileconfig에서 정책을 편집하거나 제거하지 않으면, 그 정책은 기본(제한적인) 값으로 강제 적용돼. Finder에서 .mobileconfig 프로파일을 더블 클릭한 다음, 시스템 설정의 일반 > 기기 관리에서 활성화해서 구성 프로파일을 수동으로 설치해. 시스템 설정에서 프로파일을 제거하면 Cursor에서 해당 정책도 제거돼. 구성 프로파일에 대한 자세한 내용은 Apple 문서를 참고해.

추가 정책

목표는 현재 Cursor 설정을 정책으로 끌어올리고 기존 설정을 최대한 따르면서, 이름과 동작의 일관성을 유지하는 거야. 더 많은 정책을 추가해 달라는 요청이 있다면 Cursor GitHub 저장소에 이슈를 열어줘. 팀이 해당 동작을 이미 제어하는 설정이 있는지, 아니면 원하는 동작을 제어할 새 설정을 만들어야 하는지 판단할게.

자주 묻는 질문

Cursor는 Linux에서 구성 프로필을 지원해?

Linux 지원은 로드맵에 없어. Linux에서 구성 프로필에 관심이 있다면 Cursor GitHub 리포지토리에 이슈를 열고 네 사용 사례를 자세히 공유해줘.