류경석의 SharePoint

SharePoint 서비스 계정은 어떤 걸 사용해야 하나?

2012-07-16T05:40:00.000-07:00

SharePoint라는 제품이 팜을 이루어 여러대의 머신에서 동작 하는 솔루션이다 보니 Setup시에 서비스용 계정들을 설정해야 하는 경우가 생깁니다.
처음으로 SharePoint를 설치 하는 분들의 경우엔 솔루션의 특성을 이해 하고 진행 하기 보단 일단 Setup을 해보고 설치 결과를 보고 싶어 하는 성향이 많아서 일단 Setup.exe를 돌리고 보는데요 ㅎㅎ - 이런 경우엔 "단독 실행"으로 설치 하시는 게 가장 효과적입니다.-

오늘은 기본으로 돌아가 SharePoint Setup에 필요한 계정에 대해서 확인해 보도록 하겠습니다.
SharePoint 설치를 제대로 하기 위해서는 다음과 같은 계정과 권한이 Active Directory, SQL Server, SharePoint 멤버 서버에 필요 합니다.

아래에 나오는 계정의 이름은 제가 임의로 결정한 것입니다. 계정의 이름 규칙이 있다면 적절히 바꿔 사용 하시면 됩니다.

SQL Server 서비스 계정 : SVC_SQL
SQL서버 서비스를 돌리는 계정입니다. SQL 서비스 계정을 다른 Windows서비스와 같이 System, Network Service, Local System 계정으로 돌릴 수 있지만 명시적으로 도메인 계정을 사용 하는 게 좋습니다. SharePoint서버와 다른 서버에서 SQL 서버가 돌아간다면 도메인 계정을 필수로 사용해야 합니다.

Setup 사용자 계정(사람) : SP_Admin
SharePoint 설치 패키지를 실행해서 SharePoint를 깔고 설정을 할 사람이 사용할 계정입니다.
Setup이 진행되는 동안 SQL database에 접근 하고 설치 하는 서버에 로컬 그룹을 만들기도 합니다. 그래서 SP_Admin계정은 SQL서버에 securityadmin과 dbcreator 권한이 있어야 하고 설치 하는 서버의 로컬 Administrators 그룹에 속해 있어야 합니다. 이 작업은 자동으로 되지 않기 때문에 SQL 서버에서 직접 권한을 할당하고 로컬 Administrators에다 넣어 줘야 합니다. 한가지 중요한 점은 Domain Admins 같은 도메인의 최고 권한이 필요 한 것이 아니라는 점입니다. 도메인 그룹은 Domain Users 그룹에만 있어도 됩니다.

Server Farm 계정 : SP_Farm
설치가 진행되는 동안 SP_Admin 계정으로 SharePoint 팜을 만들게 되는 데 이 팜은 SQL 서버의 DB형태로 만들어 집니다. 설치 이후 SharePoint가 SQL서버의 SharePoint 팜 database에 접근할 때 사용하는 서비스 계정이 SP_Farm입니다. 주로 중앙관리 사이트를 통해 이루어 지는 대부분의 작업이 이 서비스 계정을 통해 접근 하게 됩니다. IIS의 SharePoint 중앙관리 사이트 application pool 의 identity로 설정 되고 SharePoint Timer 서비스 계정도 이 계정으로 설정됩니다. SharePoint 가 깔리는 모든 서버의 로컬 Administrators 그룹에 이 SP_Farm 계정이 포함 되어 있어야 합니다.
이 작업은 "SharePoint 제품 설정 마법사(SharePoint Products Configuration Wizard)"가 설치 이후 돌아 갈 때 자동으로 됩니다.

웹 응용프로그램과 서비스 응용프로그램 Application Pool 계정 : SP_Service
각 웹 응용프로그램은 IIS의 application pool에서 돌아 가게 되는데 이 application pool의 identity가 SP_Service 같은 도메인 사용자 계정입니다. 이 계정은 SQL Server의 SharePoint content database 에 접근 할 때 사용 됩니다.
Office Web App이나 Search같은 서비스 응용프로그램도 웹 응용프로그램의 일종으로써 도메인 사용자 계정이 설정된 application pool에서 돌아가게 됩니다. 사용된 계정은 SharePoint 응용프로그램이 만들어 질 때 권한이 자동으로 할당 되게 됩니다.

검색 Crawler (indexer) 계정 : SP_Crawl
검색 Crawler 계정은 SharePoint 콘텐츠를 인덱싱 하는데 사용됩니다. 이 계정은 모든 SharePoint 콘텐츠에 "모두 읽기" 권한이 부여 됩니다. 만약 검색 원본이 SharePoint 콘텐츠가 아니라 공유 폴더 같은 경우엔 SP_Crawler 계정에 읽기 권한을 수동으로 할당 해 줘야 합니다.

사용자 프로필 동기화 계정 : SP_Sync
SharePoint 사용자 프로필 동기화 서비스는 Active Directory와 SharePoint간에 프로필 속성을 동기화 하는데 사용됩니다. 이 계정은 계정 정보를 읽어 올 때 도메인 수준에서 "디렉터리 변경 사항 복제(Replicate Directory Changes)" 권한이 필요 합니다. 그리고 이 서비스 계정이 팜 관리자 그룹이나 사용자 프로필 동기화 관리자 그룹에 들어 있어야 합니다.
만약 도메인의 NETBIOS이름과 도메인 이름이 다르다면 cn=configuration 컨테이너에도 "디렉터리 변경 사항 복제" 권한이 필요 합니다.
그리고 만약 SharePoint 서버에서 AD로 사용자 사진 속성을 AD의 ThumbnailPhoto같은 속성으로 overwrite해야 한다면 해당 AD개체의 ThumbnailPhoto에는 read권한 밖에 주어지지 않으므로 명시적으로 write권한을 추가 해 줘야 합니다.

이렇게 SharePoint 2010 에서 사용되는 계정을 정리 해 보았습니다. 뭐 Domain Admins에 들어 있는 계정 하나 만들어서 몽땅 그 계정 하나로 설정 해 버리면야 문제가 없어 보이긴 합니다만… 첫 번째 보안에 위험 하겠지요. 두 번째로는 그 계정 하나가 문제가 발생하면 SharePoint 전체 서비스가 중단되는 사태가 벌어 질 수도 있을 것입니다.
정확히 SharePoint 서비스가 어떤 작업을 하는지 확인하고 어떤 계정이 어떤 권한을 가져야 하는지 확인이 필요 할 것입니다.

Your search cannot be completed because this site is not assigned to an indexer.

2011-04-04T20:15:00.001-07:00

증상

Search 서비스에 API를 통해 검색을 할 때 제목과 같은 에러가 발생 하는 경우 입니다.

원인

Search설정에는 문제없이 되는 것 처럼 보이는데요 이럴 땐 일단 Conent DB의 Search 서버 설정이 제대로 되어 있는지 확인 해야 합니다.

해결

Central Administratoion > Application Management > Manage content database >

만약 “Searh Server” 설정이 비활성화 되어 있으면 Central Administration > System Settings > Manage services on server 에서 SharePoint Foundation Help Searh 서비스가 제대로 시작되어 있는지 확인 해 보시기 바랍니다.

Field Name, InternalName, StaticName, DisplayNane, _x0020_

2011-04-03T06:03:00.001-07:00

Custom Field정의에 대해서 알아 보겠습니다.

Custom Field를 정의 할 때 필수 attribute는 Name, Type, ID 입니다.

ID는 “{}”로 둘러 싸인 GUID값이고, Type은 SharePoint에서 사용 가능한 Type입니다.

MSDN의 File element reference

<Field ID="{1511BF28-A787-4061-B2E1-71F64CC93FD5}"Name="DateOpened"DisplayName="Date Opened"Type="DateTime"Format="DateOnly"Required="FALSE"Group="Financial Columns"><Default>[today]</Default></Field>

Field를 customize할 때 가장 유의 해야 할 부분은 바로 Name 속성입니다.

Name

Name은 SPField 개체를 통해 InternalName 속성로 노출 하는 값으로써 Site내에서 Unique 하고 0-9 숫자와 알파벳 글자만을 사용 할 수 있습니다. 만약 다른 캐릭터가 오면 _x0000_ 형태로 인코딩을 해버립니다. 즉, “File Type” 이라는 이름은 “File_x0020_Type”으로 바꾸는 것이죠. 이건 한글 필드이름일 때는 더욱 문제가 됩니다. 디코딩을 해보기 전까지는 전혀 어떤 글자인지 모를 이름이 “InternalName”에 들어가 있는 것입니다. 그리고 마지막으로 주의해야 할 것은 이름의 글자수가 32자리 라는 것입니다. 이상 넘어가는 글자는 그냥 잘라 먹습니다.

StaticName

StaticName은 별도로 지정하지 않으면 Name 값이 동일하게 들어 갑니다. InternalName은 읽기 전용이라 field 생성 후 변경이 불가능 하지만 이 StaticName은 API를 통해 변경이 가능합니다. 이 속성은 SPFieldCollection.GetField() 메서드에서 해당 field를 찾아 올 때 InternalName과 함께 사용 할 수 있습니다.

DisplayName

DisplayName은 UI에서 노출 되는 field 이름입니다. 당연히 공백을 포함 모든 캐릭터를 사용 할 수 있습니다.

결론

Name 속성은 무조건 공백없는 알파벳, 숫자로 만들어야하고 32자를 넘지 말아야 합니다. StaticName은 별도록 지정 말고 Name과 같이 사용하는 것이 좋습니다.

the field with ID defined in feature was found in the current site collection or in a sub site

2011-04-01T04:37:00.001-07:00

증상

VS에서 Field를 배포 하려 할 때 첫번째엔 문제가 없는데 두번째 부터 아래와 같이 에러가 나면서 Feature Activation에 실패 하는 경우가 있습니다.

‘Error occurred in deployment of step ‘Activate Features’: the field with ID <New GUID> defined in feature <FeatureGUID> was found in the current site collection or in a sub site.

원인

원인은 Field 선언시에 ID값을 선언 할 때 "{}” 로 둘러 싸지 않아서 그렇습니다.

<Field ID="A409C79A-F1C3-43B9-A602-160FF81E0AF8" Name="UserID" Type="Text" />

VS의 버그에 가깝습니다.

해결

해결 책은 일단 ID값을 “{}”로 감싸고 해당 솔루션 패키지를 Retract(취소)한 후 VS를 다시 켠 후 다시 Deploye(배포) 하면 해결 됩니다.

참고

http://support.microsoft.com/kb/2022443

SharePoint 2010 Form Based Authentication 및 Custom Login Page

2011-02-09T18:15:00.000-08:00

SharePoint 2010 에서 FBA를 구성 하는 방법과 Custom Login Page를 만드는 방법을 정리 해 봤습니다.

1. 중앙 관리 사이트 Membership, Role Provider설정하기	중앙 관리 사이트 web.config 파일을 열어 아래와 같이 추가 하여 수정한다. <configuration />안쪽에 <connectionStrings> <add name="SQLConnectionString" connectionString="data source=SQLServerName;Integrated Security=SSPI;Initial Catalog=aspnetdb" /> </connectionStrings> <system.web></system.web> 사이에 <roleManager defaultProvider="AspNetWindowsTokenRoleProvider" enabled="true" cacheRolesInCookie="false"> <providers> <add connectionStringName="SQLConnectionString" applicationName="/" description="Stores and retrieves roles from SQL Server" name="SQL-RoleManager" type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" /> </providers> </roleManager> <membership defaultProvider="SQL-MembershipProvider"> <providers> <add connectionStringName="SQLConnectionString" passwordAttemptWindow="5" enablePasswordRetrieval="false" enablePasswordReset="false" requiresQuestionAndAnswer="true" applicationName="/" requiresUniqueEmail="true" passwordFormat="Hashed" description="Stores and Retrieves membership data from SQL Server" name="SQL-MembershipProvider" type="System.Web.Security.SqlMembershipProvider, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" /> </providers> </membership> 아래와 같이 "PeoplePickerWildcards" 노드를 찾아 추가한다. <PeoplePickerWildcards> <clear /> <add key="AspNetSqlMembershipProvider" value="%" /> <add key="SQL-MembershipProvider" value="%" /> </PeoplePickerWildcards>
2. Security Token Service Membership, Role Provider설정하기	STS서비스의 web.config 파일은 %programfiles%\common files\Microsoft Shared\web server extensions\14\WebServices\SecurityToken 에 있음. <configuration />안쪽에 <connectionStrings> <add name="SQLConnectionString" connectionString="data source=SQLServerName;Integrated Security=SSPI;Initial Catalog=aspnetdb" /> </connectionStrings> <system.web> <roleManager defaultProvider="c" enabled="true" cacheRolesInCookie="false"> <providers> <add name="c" type="Microsoft.SharePoint.Administration.Claims.SPClaimsAuthRoleProvider, Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" /> <add connectionStringName="SQLConnectionString" applicationName="/" description="Stores and retrieves roles from SQL Server" name="SQL-RoleManager" type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" /> </providers> </roleManager> <membership defaultProvider="i"> <providers> <add name="i" type="Microsoft.SharePoint.Administration.Claims.SPClaimsAuthMembershipProvider, Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" /> <add connectionStringName="SQLConnectionString" passwordAttemptWindow="5" enablePasswordRetrieval="false" enablePasswordReset="false" requiresQuestionAndAnswer="true" applicationName="/" requiresUniqueEmail="true" passwordFormat="Hashed" description="Stores and Retrieves membership data from SQL Server" name="SQL-MembershipProvider" type="System.Web.Security.SqlMembershipProvider, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" /> </providers> </membership> </system.web>
3. ASPNET Membership DB설치	1. SharePoint 2010 서버에서 명령 프롬프트를 연다. 2. C:\Windows\Micrsooft .Net\Framework64\v2.0.50727 폴더로 이동 3. “aspnet_regsql.exe” 실행. 실행 하면 아래와 같은 마법사가 나옴. Database 이름을 <default>로 놓고 진행하면 "aspnetdb" 라는 멤버쉽 db가 생성됨. 4. Aspnetdb에 SharePoint Service Application Pool 계정이 읽고 쓰기 권한을 할당 함.
4. Web Application 생성	Form Based Authentication을 지원하는 Web Application을 아래와 같이 생성한다. 1. 중앙 관리사이트를 연다. 2. 응용프로그램 관리 아래의 웹 응용프로그램 관리 클릭 3. 리본 메뉴의 "new" 클릭 4. 페이지 상단 Claims based Authentication 선택 a. Claims Based Authentication 선택 a. Host Header와 Port 지정 c. 익명 인증 설정 d. \Membership Provider와 Role Provider 이름 설정 e. Custom Sign In Page 지정 f. Contents Database이름 변경 g. Save를 눌러 실행한다. 5. 사이트 모음 생성하기. a. 앞서 실행 결과 화면에서 "Create Site Collection"을 클릭 b. 창을 닫았다면 응용 프로그램 관리 클릭 후 사이트 모음 생성 클릭 c. 웹 응용프로그램 선택 확인 d. 사이트 제목과 템플릿 지정 e. 사이트 관리자 지정 f. OK버튼을 눌러 생성완료
5. 생성된 Web Application web.config 수정	C:\inetpub\wwwroot\wss\VirtualDirectories\ 아래에서 생성한 Web Application 폴더내의 web.config 파일을 연다. <configuration />안쪽에 <connectionStrings> <add name="SQLConnectionString" connectionString="data source=SQLServerName;Integrated Security=SSPI;Initial Catalog=aspnetdb" /> </connectionStrings> <system.web></system.web> 사이에 <roleManager defaultProvider="c" enabled="true" cacheRolesInCookie="false"> <providers> <add name="c" type="Microsoft.SharePoint.Administration.Claims.SPClaimsAuthRoleProvider, Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" /> <add connectionStringName="SQLConnectionString" applicationName="/" description="Stores and retrieves roles from SQL Server" name="SQL-RoleManager" type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" /> </providers> </roleManager> <membership defaultProvider="i"> <providers> <add name="i" type="Microsoft.SharePoint.Administration.Claims.SPClaimsAuthMembershipProvider, Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" /> <add connectionStringName="SQLConnectionString" passwordAttemptWindow="5" enablePasswordRetrieval="false" enablePasswordReset="false" requiresQuestionAndAnswer="true" applicationName="/" requiresUniqueEmail="true" passwordFormat="Hashed" description="Stores and Retrieves membership data from SQL Server" name="SQL-MembershipProvider" type="System.Web.Security.SqlMembershipProvider, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" /> </providers> </membership> 아래와 같이 "PeoplePickerWildcards" 노드를 찾아 추가한다. <PeoplePickerWildcards> <clear /> <add key="AspNetSqlMembershipProvider" value="%" /> <add key="SQL-MembershipProvider" value="%" /> </PeoplePickerWildcards> Command Prompt에서 IISRESET 이후 사이트를 연다.

Web Part Error: UnsafeControlException

2011-01-16T17:48:00.001-08:00

WebPart Provisioning이 잘 되지 않고 아래와 같은 에러가 화면에 나오는 경우가 있습니다.

Web Part Error: A Web Part or Web Form Control on this Page cannot be displayed or imported. You don't have Add and Customize Pages permissions required to perform this action.

Hide Error Details

[UnsafeControlException: A Web Part or Web Form Control on this Page cannot be displayed or imported. You don't have Add and Customize Pages permissions required to perform this action.]

at Microsoft.SharePoint.WebPartPages.WebPartImporter.CreateWebPart(Boolean clearConnections)

at Microsoft.SharePoint.WebPartPages.WebPartImporter.Import(SPWebPartManager manager, XmlReader reader, Boolean clearConnections, Uri webPartPageUri, SPWeb spWeb)

at Microsoft.SharePoint.WebPartPages.SPWebPartManager.CompressWebPartNoSave(Boolean isClosed)

원인은 Anonymous가 설정 된 사이트인 경우 사이트 최초 시작 시에 anonymous로 바로 연결 하게 되면 WebPart Page내에 Provisioning된 webpart를 제대로 불러오지 못해서 그런 것 같습니다.

사이트 편집권한이 있는 사용자로 로그인 후 다시 anonymous로 접근하면 해결 되더군요.

User Profile 관련 Hotfix가 나왔습니다.

2010-08-19T21:44:00.001-07:00

User Profile 관련해서 설정과 작동에 버그가 좀 있는 것 같았는데요.. 다행히 hotfix가 나왔네요.

http://support.microsoft.com/kb/983497/ ->기본적으로 한글로 번역기가 돌려 보여줍니다. 번역 품질이 쪼금 떨어지네요

http://support.microsoft.com/kb/983497/en-us –> 영문

web.Navigation.TopNavigationBar is null

2010-08-02T19:08:00.001-07:00

사이트 정의를 새로 만들면서 navigation을 새로 만들어야 하는 상황이었습니다.

Feature를 하나 생성 한 다음 TopNavigationBar에 접근해서 기존 메뉴 노드를 삭제하고 제가 필요한 링크를 다는 작업을 하는데 문제가 시작 되었습니다.

   1:     2: public override void FeatureActivated(SPFeatureReceiverProperties properties)   3: {   4:     SPNavigationNode nodeToAdd = new SPNavigationNode("Test1", web.Url +    5:     "/Pages/PageView.aspx");   6:     web.Navigation.TopNavigationBar.AddAsLast(nodeToAdd);   7: ...   8: }

위 코드에서 web.Navigation.TopNavigationBar 개체가 자꾸 null이 들어 오는 것입니다.

조금 research를 해 봤습니다.

의외로 TopNavigationBar가 null인 상황이 자주 발생 하는 것 같았습니다.

http://stackoverflow.com/questions/2206240/sharepoint-quicklaunch-and-topnavigationbar-dissapearing

위 url에서는 아예 TopNavigationBar레코드가 사라지는 경우가 있으니 아예 만들라고 이야기를 하더군요.

http://statto1974.wordpress.com/2008/04/09/beware-of-deleting-global-navigation-nodes-in-spwebnavigationglobalnodes/

여기서는 navigaion node를 잘못 삭제하면 그런 증상이 발생한다고 하는데 제 경우에는 사이트 생성시 부터 TopNavigationBar가 보이지 않는 증상이었습니다.

SharePoint의 Navigation 개체는 기본적으로 root 아래에 3개의 Node가 제공 됩니다.

Home : 1000

Top Navigation Bar : 1002

Quick Lauch Bar : 1025

이상한 것은 Quick Lauch Bar 개체는 접근에 문제가 없다는 것이었습니다.

한참동안의 고민끝에 원인을 알아 냈는데요 이유는 onet.xml 에 NavBar 가 없어서 였습니다. 제 딴에는 Navigation을 새로 만든다고 onet.xml에 NavBars 를 몽땅 들어냈는데 TopNavigationBar의 경우에는 여기에 꼭 있어야 (ID=1000) web.Navigation.TopNavigationBar property로 노출이 됩니다.

   1:     2: <Project Title="DocExport" Revision="2" ListDir="" xmlns:ows="Microsoft    3: SharePoint" xmlns="http://schemas.microsoft.com/sharepoint/">   4:     <NavBars>   5:     <NavBar Name="SharePoint Top Navbar" ID="1002">   6:     </NavBar>   7:     </NavBars>

SharePoint의 길은 멀고도 험하다는 걸 느끼는 하루였네요 T.T

SharePoint가 작동중인 Application Pool Worker Process ID 찾기

2010-08-01T17:16:00.001-07:00

SharePoint 기반 개발을 하다가 보면 Process를 attatch 해서 debugging을 해야 할 일이 자주 발생 합니다. 그런데 IIS에서 돌아가는 Application Pool이 많다 보면 어떤 worker process(w3p.exe)가 내 웹애플리케이션을 돌리고 있는지 알 수가 없습니다. 그럴 때는 iis의 appcmd를 사용해서 현재 작동중인 worker process정보를 알아 낼 수 있습니다.

C:\Windows\System32\inetsrv>appcmd list wp

SharePoint 2010 오역 모음

2010-07-22T18:43:00.001-07:00

이번 SharePoint 2010에도 한글 버전의 잘못된 번역이 자꾸 눈에 띄는군요 요번에는 좀 정리를 해 보겠습니다.

1.Windows 토큰 서비스에 대한 클레임

중앙관리 -> 응용프로그램 관리 -> 서비스 응용 프로그램 탭-> 서버의 서비스 관리에 특정 서버에서 작동중인 서비스 목록을 볼 수 있습니다. 그 중에서 "Windows 토큰 서비스에 대한 클레임" 이라는 서비스 이름이 있네요 이 서비스 명은 "Claim to Windows Token Service"을 오역 한 것입니다. "클레임을 Windows 토큰으로 변환 하는 서비스"가 맞는 의미입니다.

2.도서관

처음에는 이 메뉴를 보고 SharePoint에 새로운 기능이 들어 간 것으로 알았습니다. --;; 원문은 Library 입니다만 한글로도 그동안 라이브러리라고 사용하고 있습니다. 이 2010에서도 그렇구요 아래 그림에서만 "도서관"이라고 번역을 했습니다. 번역의 일관성이 없네요

3. 사용자 프로필 동기화 서비스
요 부분은 오역이라기 보다는 버그에 가깝습니다. User Profile에 관련된 서비스는 User Profile Service와 User Profile Synchronization Service 이 두개가 있습니다. 그런데 두번째 만 한글로 “사용자 프로필 동기화 서비스”로 번역을 했습니다. 전 이 User Profile Synchronization Service가 RTM나오면서 User Profile Service로 통합 된 줄 알았습니다. 요것 때문에 며칠을 고생했네요. T.T

4.콘텐츠 형식에서의 목록정의
이건 SharePoint가 아니라 Visual Studio 2010의 SharePoint 프로젝트 템플릿 중 하나의 이름입니다.

번역 전 원문은 “List Definition from Content Type” 입니다. 콘텐츠 형식을 이미 가지고 있을 때 이놈을 바탕으로 목록 정의를 만드는 용도입니다. 의미 전달이 제대로 되지 않고 있네요 “콘텐츠 형식으로 목록정의 만들기” 정도가 어떨까 합니다.

앞으로 눈에 띄는 대로 이 포스트에 업데이트 해 보도록 하겠습니다.

Secure Store Service

2010-07-21T20:56:00.001-07:00

지난번 포스트에서 BCS를 통해 External Content Type을 사용하는 예제를 만들어 봤습니다. 그런 시나리오에서 제가 의도적으로 누락 했던 부분이 있습니다. 바로 BCS저장소에 접근 할 때 사용 하게 되는 인증 입니다. 그래서 서버 로컬에서 Administrator로 로그인 했을 땐 문제가 없지만 웹서버 바깥에서 로그인 하게 되면 DB인증이 실패 하는 경우가 발생 합니다.

BCS뿐 아니라 SharePoint는 Presentation layer의 역할을 가지고 있기 때문에 여러 데이터 소스로 부터 데이터를 취합 하는 시나리오가 자주 발생 하게 됩니다. 그럴 때 마다 가장 먼저 해결 해야 하는 부분이 데이터 소스에 접근 할 때 어떤 인증 방식으로 어떤 identity를 사용 할 것 인가 하는 문제 입니다.

이 때 SharePoint에서 제공 하는 솔루션이 Secure Storage Service 입니다. SSS는 2007 버전에서는 SSO서비스라고 이름 붙였습니다만 이름이 타 Web SSO와 혼동을 일으키는 부분도 있어서 이름을 바꾸어 업그레이드 되었습니다.

이제 지난 포스트에 이어서 SSS를 설정 하는 방법을 알아 보겠습니다.

중앙 관리에서 서비스 응용 프로그램 관리로 이동합니다.

만약 SharePoint 팜서비스 구성 마법사를 통해 Secure Store Service를 이미 만들어 둔 상태라면 아래 단계는 건너 뛰어도 됩니다.

서비스 응용 프로그램 이름과 데이터베이스 이름, 응용프로그램 풀 이름을 설정 합니다.

서비스 응용 프로그램 목록에서 제대로 Secure Store Service가 만들어 졌는지 확인이 가능합니다.

"관리"를 클릭해서 나머지 설정을 진행 합니다.

"새 키 생성"을 클릭합니다.

키의 암호를 지정합니다.

이제 "새 응용 프로그램"을 클릭

대상 응용 프로그램 ID, 표시 이름, 연락처 전자메일을 설정 합니다. 대상 응용 프로그램 형식은 "그룹:"을 선택 합니다. "그룹"은 Windows 기준으로 말씀드리자면 "Domain Users같은 그룹에 속한 사용자 아이디가 이 "MyDatabase"라는 응용프로그램에 접근 한다면" 이라는 의미 입니다.

대상응용 프로그램 관리자에는 적당히 게정을 지정을 지정 하시고 중요 한 부분은 "멤버" 부분입니다. 어떤 사용자 그룹이 이 "대상 응용 프로그램"을 사용할 것인가를 지정하는 부분입니다. 다시 말하자면 "Domain Users"그룹에 속한 사용자들이 이 "MyDatabase 대상 응용 프로그램"에 접근시에 작동 한다는 것을 뜻합니다.

"MyDatabase" 대상 응용 프로그램이 만들어 진 것을 확인 할 수 있습니다.

이제 이 대상프로그램에 접근한 사용자가 어떤 ID로 바꿀 것인가를 지정 합니다. "자격 증명 설정"을 클릭합니다.

자격 증명 설정 화면에서 대상 응용 프로그램에 접근시에 가장할 자격 증명을 지정 합니다.

이제 Secure Store Service에 MyDatabase라는 대상 응용프로그램 설정이 완료 되었습니다. 이 설정을 External Content Type에서 사용 해 보도록 하겠습니다.

앞서 말씀 드린 대로 Secure Store Service는 이전 버전의 SSO서비스 기능을 확장 해서 SharePoint 2010 의 인증 추가 기능은 Claim 티켓까지 사용 할 수 있도록 확장 되었습니다. 외부 시스템과의 연동 시에 Secure Store Service를 잘 활용 하면 보안 인증에 관련된 많은 부분을 손 쉽게 처리 할 수 있습니다.

Business Connectivity Service를 이용한 SQL DB 연동

2010-07-20T23:55:00.001-07:00

BCS(Business Connectivity Service)에 대해서 좀 알아 보고 데모를 만들어 볼까 합니다.

BCS는 SharePoint 2007의 BDC가 업그레이드 된 것으로 이름을 BCS로 바꿨습니다.

이름을 바꿀 정도면 많은 부분들이 바뀌었겠지요. 가장 눈에 띄는 부분은 BCS 뒷단 데이터저장소에 대한 Write지원입니다. 기존에는 거의 Read Only작업만을 수행 할 수 있었지요

아울러 BCS구성을 위한 Desinger툴이 SharePoint Desinger 2010에 포함 되어 있다는 것 입니다. 기존에는 Application Definition파일을 수동으로 만들거나 Third party 툴을 사용 해야만 했었습니다. 이 SPD(SharePoint Desinger)안쪽의 툴이 CRUD작업의 코드를 자동으로 생성 해 주는 착한 일도 합니다.

이렇게 CRUD작업을 위해 BCS는 External Content Type이라는 개념을 도입해 SharePoint 목록(External List)과 바로 연결 할 수 있도록 구성 되어 있습니다.

MS SQL서버의 테이블을 외부 데이터로 설정하고 목록으로 노출 시키는 시나리오입니다.

먼저 샘플 DB를 생성 하도록 하겠습니다.

아래 스크립트로 MyDatabase라는 DB에 BCS 연결을 만들어 봅시다.

/************************************************

CREATE DATABASE [MyDatabase]

Use MyDatabase

CREATE TABLE [dbo].[Customer](

[CustomerId] [int] NOT NULL,

[FullName] [varchar](50) NOT NULL,

[ModifyDate] [datetime] NOT NULL,

[CreateDate] [datetime] NOT NULL,

CONSTRAINT [PK_Customer] PRIMARY KEY CLUSTERED

(

[CustomerId] ASC

)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]

) ON [PRIMARY]

CREATE TABLE [dbo].[Order](

[OrderId] [int] NOT NULL,

[CustomerId] [int] NOT NULL,

[Quantity] [int] NOT NULL,

[ModifyDate] [datetime] NOT NULL,

[CreateDate] [datetime] NOT NULL,

CONSTRAINT [PK_Order] PRIMARY KEY CLUSTERED

(

[OrderId] ASC

)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]

) ON [PRIMARY]

ALTER TABLE [dbo].[Order] WITH CHECK ADD CONSTRAINT [FK_Order_Customer] FOREIGN KEY([CustomerId])

REFERENCES [dbo].[Customer] ([CustomerId])

ALTER TABLE [dbo].[Order] CHECK CONSTRAINT [FK_Order_Customer]

ALTER TABLE [dbo].[Order] ADD CONSTRAINT [DF_Order_ModifyDate] DEFAULT (getdate()) FOR [ModifyDate]

ALTER TABLE [dbo].[Order] ADD CONSTRAINT [DF_Order_CreateDate] DEFAULT (getdate()) FOR [CreateDate]

//--------------------------------------

DB생성 이후 DB의 보안 설정에서 SharePoint 웹애플리케이션이 돌아가는 IIS Application Pool의 계정이 접근 권한을 적절히 줬는지 확인 해야 합니다.

이번 시나리오 에서는 이 MS SQL DB에 SharePoint Application Pool의 계정으로 접근 할 것이기 때문입니다.

SPD로 외부 데이터를 노출할 사이트를 엽니다.

"탑색" 창에서 "외부 컨텐츠 형식"을 클릭해서 "외부 컨텐츠 형식"을 새로 만듭니다.

SQL서버를 선택합니다.

데이터베이스 이름을 제대로 설정하고 "확인"을 누릅니다.

아래 화면에서 "모든 작업 만들기"를 통해 이테이블에 대한 CRUD작업을 자동으로 생성합니다.

각 필드에 대해서 "선택 컨트롤에 표시"를 체크 합니다.

"ModifyDate" "타임스탬프 필드"를 체크해서 해당 Row의 timestamp역할을 하도록 설정합니다.

필터 구성은 이 시나리오에서 사용하지 않으므로 바로 마치면 아래와 같이 각 CRUD작업이 생성되어 있음을 확인 할 수 있습니다.

Ctrl+s를 눌러서 저장하면 이제 폼을 구성 하고 목록으로 만들어 노출 할 수 있습니다.

목록 이름을 설정하고 확인을 클릭

이제 바로가기 메뉴에 "Customer" 목록이 나오는 것을 확인 할 수 있습니다. 하지만 아래와 같이 접근이 되지 않고 에러가 납니다.

중앙관리 사이트에서 해당 BCS개체의 사용 권한을 추가 해 줘야 합니다.

권한 설정 화면에서 찾을 이름을 "authenticated users"라고 치고 이름을 확인 합니다.

모든 사용자를 추가 하고 각 권한을 체크 한 후 확인을 클릭합니다.

이제 다시 Customer목록으로 돌아와 접근이 되는지 확인 합니다.

한번 새로운 데이터를 만들어 보겠습니다.

데이터를 입력하고 저장 합니다.

아래와 같이 목록에 입력된 내용이 표시 되는 것을 확인 할 수 있습니다.

DB에서 Query를 직접 해서 테이블에 입력이 되었는지 확인 해 보겠습니다.

위와 같이 DB입력 까지 된 것을 확인 했습니다.

SharePoint 2010의 BCS기능은 External Content Type과 External List의 도입으로 기존 LoB Application의 데이터를 SharePoint Presentation까지 별도의 코드가 거의 없이 바로 표현이 가능 할 뿐 아니라 Data의 CRUD전체 작업을 할 수 있습니다.

SharePoint 2010 Form기반 인증 설정하기

2010-07-05T23:43:00.001-07:00

SharePoint 2010 에서 Form 기반 인증 하는 방법을 정리 해 봅니다.

SharePoint 2010은 Form기반 인증할 때 Security Token Service를 통한 Claim 기반 인증을 사용 하도록 변경 되었습니다.

설정을 해야 하는 web.config 가 하나 더 있는 셈입니다.

단계를 정리 해 보자면

1. 해당 Web Application의 Web.config 수정

2. STS Web Service Web.config 수정

3. 중앙 관리 사이트 Web.config 수정

4. Web Application에 관리자 계정 권한 추가

이런 순서라고 보시면 됩니다.

일단 Form기반 인증을 설정할 Web Application을 생성 하겠습니다.

SharePoint 중앙관리 사이트를 열어 응용 프로그램 관리 메뉴로 들어 갑니다.

새 웹 응용 프로그램 만들기 창에서 인증 값을 "클레임 기반 인증"으로 설정 하고 클레임 인증 유형에 "FBA"를 선택 합니다. - 번역은 "양식 기반 인증" 이군요 제발 form을 양식으로 번역 하지 않았으면 좋겠습니다만-

ASP.NET 멤버 자격 공급자 이름 에 "LdapMemeber", ASP.NET 역할 자격 공급자 이름에 "LdapRole"이라고 설정 합니다. 이 값은 web.config 파일들에서 설정할 이름이기 때문에 그 provider이름과 맞춰만 준다면 상관 없습니다.

클레임 인증 유형에서 Windows 인증 사용은 그대로 둬야 합니다. 빼면 검색엔진이 이 사이트를 검색 할 수 없게 됩니다.

나머지 값은 그대로 두고 확인을 눌러 응용 프로그램을 만듭니다. 이후에 바로 사이트 모음을 바로 만드는게 좋습니다.

이제 Memebership과 Role Provider설정을 각 web.config 에 할 순서 입니다.

방금 생성한 Web Application의 web.config 파일을 열어 아래와 같이 추가 합니다.

중앙 관리 사이트의 web.config 파일도 열어서 아래와 같이 설정 합니다.

<add name="LdapMember" type="Microsoft.Office.Server.Security.LdapRoleProvider, Microsoft.Office.Server,Version=14.0.0.0,Culture=neutral,PublicKeyToken=71e9bce111e9429c"

server="win2k8r2"

port="389"

useSSL="false"

userDNAttribute="distinguishedName"

userNameAttribute="sAMAccountName"

userContainer="CN=Users,DC=Contoso,DC=Com"

userObjectClass="person"

userFilter="(ObjectClass=person)"

scope="Subtree"

otherRequiredUserAttributes="sn,givenname,cn"/>

</providers>

</membership>

<add name="LdapRole" type="Microsoft.Office.Server.Security.LdapMembershipProvider, Microsoft.Office.Server,Version=14.0.0.0,Culture=neutral,PublicKeyToken=71e9bce111e9429c"

server="win2k8r2"

port="389"

useSSL="false"

groupContainer="CN=Users,DC=Contoso,DC=Com"

groupNameAttribute="cn"

groupNameAlternateSearchAttribute="samAccountName"

groupMemberAttribute="member"

userNameAttribute="sAMAccountName"

dnAttribute="distinguishedName"

groupFilter="(ObjectClass=group)"

userFilter="(ObjectClass=person)"

scope="Subtree"

</providers>

</roleManager>

마지막으로 STS Web Service의 web.config 파일을 설정 합니다. STS 서비스는 아래 그림과 같은 경로에서 찾을 수 있습니다.

STS의 web.config파일을 설정 할 때는 roleManager element의 defaultProvider 속성 값을 빼야 합니다.

이제 중앙관리 사이트의 응용 프로그램 관리 메뉴로 돌아 옵니다.

추가한 응용프로그램에 form기반 인증의 관리자를 추가 해야 합니다.

아래와 같이 추가한 웹 응용프로그램을 선택하고 "사용자 정책"을 선택합니다.

영역선택에서 "기본"을 선택합니다.

사용자 선택에서 주소록 아이콘을 클릭합니다.

Administrator를 검색하면 아래와 같이 AD와 Form두개의 검색 결과가 나오는 것을 확인 해 볼 수 있습니다.

Form인증의 Administrator을 추가 하고 확인 한 후 빠져나옵니다.

이제 해당 응용프로그램을 브라우져를 통해 들어가 보면 아래와 같이 자격 증며을 선택 하는 화면이 나오고 "양식 인증"을 선택 하면 그 아래와 같이 기본 login 화면이 나타나게 됩니다.

제대로 인증에 성공하면 아래와 같이 환영 메시지를 볼 수 있습니다.

텍스트 큐브에서 다시 이사옵니다.

2010-07-01T05:10:00.001-07:00

구글에서 textcube.com 블로그를 더이상 지원 하지 않는다는 군요 T.T

sharedmind.textcube.com 블로그를 이쪽으로 다시 옮겨와야 할 것 같습니다.

다음주 부터 SharePoint 프로젝트에 투입 됩니다. 재미있을 것 같은데요 블로깅 할 꺼리도 많을 것 같고 SharePoint 2010으로 진행 하는 첫 프로젝이 될 것 같습니다.

조만간 새로운 포스팅으로 뵙도록 하겠습니다.