Konfigurowanie uwierzytelniania opartego na serwerze z użyciem usługi Customer Engagement (on-premises) i lokalnego programu SharePoint
Uwaga
Jeśli włączono tryb Tylko ujednolicony interfejs, przed użyciem procedur opisanych w tym artykule wykonaj następujące czynności:
- Wybierz pozycję Settings (
) na pasku nawigacyjnym. - Wybierz pozycję Ustawienia zaawansowane.
W tym temacie opisano sposób konfigurowania integracji na serwerze między Dynamics 365 Customer Engagement (on-premises) a Microsoft SharePoint (wersja lokalna).
Konfigurowanie integracji na serwerze z Customer Engagement (on-premises) i SharePoint
Wykonaj kroki, w podanej kolejności, aby skonfigurować Customer Engagement (on-premises) z Microsoft SharePoint Server w wersji lokalnej.
Ważne
- Polecenia programu PowerShell powinny być uruchamiane w trybie Administrator. Zobacz: Jak uruchomić program PowerShell?
- Jeśli zadanie nie zostanie ukończone, i na przykład polecenie PowerShell zwróci komunikat o błędzie, problem musi zostać rozwiązany przed przejściem do następnego polecenia, zadania lub kroku.
- Po włączeniu opartej na serwerze integracji z programem SharePoint nie będzie można powrócić do poprzedniej metody uwierzytelniania opartego na kliencie. W związku z tym nie można używać składnika Lista Microsoft Dynamics CRM po skonfigurowaniu organizacji Customer Engagement (on-premises) dla integracji z SharePoint na serwerze.
Sprawdź wymagania wstępne
Przed skonfigurowaniem Customer Engagement (on-premises) i SharePoint (wersja lokalna) do integracji opartej na serwerze, należy spełnić poniższe uprawnienia i wymagania wstępne.
Wymagane uprawnienia
Customer Engagement (on-premises)
Rola zabezpieczeń Administrator systemu — ten element jest wymagany, aby uruchomić opartego na serwerze kreatora integracji z SharePoint w Customer Engagement (on-premises).
Jeśli używasz certyfikatu z podpisem własnym dla celów dokonania oceny, musisz być członkiem lokalnej grupy Administratorzy na komputerze, na którym uruchomiony jest Dynamics 365 Server.
SharePoint wersja lokalna
- Członkostwo w grupie Administratorzy farmy - to jest wymagane do uruchamiania większości poleceń Windows PowerShell na serwerze SharePoint.
Wymagania wstępne SharePoint
Jedna z poniższych wersji SharePoint:
Edycja Sharepoint Service Subscription.
SharePoint 2019, wersja lokalna
Oparta na serwerze integracja między Dynamics 365 Customer Engagement (on-premises) a Microsoft SharePoint 2019 w wersji lokalnej wymaga Microsoft Dynamics 365 Server, wersja v9.0 (wersja lokalna), Aktualizacja 0.13 lub w nowszej wersji.
SharePoint 2016, wersja lokalna
Microsoft SharePoint 2013, wersja lokalna, z dodatkiem Service Pack 1 (SP1) lub nowsza wersja z poniższymi aktualizacjami.
Zainstaluj aktualizację zbiorczą z kwietnia 2019 (CU) dla rodziny produktów SharePoint 2013. Aktualizacja zbiorcza z kwietnia 2019 roku obejmuje wszystkie poprawki SharePoint 2013 (w tym wszystkie poprawki zabezpieczeń SharePoint 2013) wydane od momentu premiery SP1. Aktualizacja zbiorcza z kwietnia 2019 roku nie zawiera dodatku SP1. Przed rozpoczęciem instalacji aktualizacji zbiorczej z 2019 roku należy zainstalować dodatek SP1.
Konfiguracja rozwiązania SharePoint
SharePoint musi być skonfigurowany tylko dla pojedynczego wdrożenia farmy.
Aby użyć domyślnego mapowania uwierzytelniania opartego na oświadczeniach, domena Active Directory, w której zlokalizowany jest serwer SharePoint i Dynamics 365 Server muszą być takie same, albo domena, w której zlokalizowany jest serwer SharePoint musi ufać domenie, w której zlokalizowany jest Dynamics 365 Server. Więcej informacji: Informacje o mapowaniu uwierzytelniania opartego na oświadczeniach
Witryna SharePoint musi być skonfigurowana do używania TLS/SSL (HTTPS), a certyfikat musi zostać wydany przez publiczny główny urząd certyfikacji. Więcej informacji: SharePoint: Informacje o certyfikatach bezpiecznego kanału SSL
Należy utworzyć i uruchomić serwer proxy aplikacji usługi zarządzania aplikacją. Więcej informacji: Skonfiguruj środowisko aplikacji dla SharePoint
Należy skonfigurować i uruchomić aplikację obsługi profilu użytkownika. Więcej informacji: Tworzenie, edytowanie lub usuwanie aplikacji obsługi profilu użytkownika w SharePoint Server 2013
Aby umożliwić udostępnianie dokumentów musi być włączona usługa wyszukiwania programu SharePoint. Więcej informacji: Tworzenie i konfigurowanie aplikacji usługi Wyszukiwania w SharePoint Server
Dla funkcji zarządzania dokumentami przy użyciu aplikacji mobilnych aplikacji Microsoft Customer Engagement (on-premises), lokalny serwer SharePoint musi być dostępny przez Internet.
Aby umożliwić użytkownikom tworzenie bibliotek dokumentów SharePoint z Customer Engagement (on-premises), wymagane są następujące uprawnienia i konfiguracje:
Konto Active Directory użytkownika Customer Engagement (on-premises) musi być członkiem grupy Członkowie witryny na zbiorze witryny SharePoint, gdzie dokumenty są przechowywane.
Domyślnie, mapowanie uwierzytelniania opartego na oświadczeniach będzie używać do mapowania adresu e-mail SharePoint użytkownika Customer Engagement (on-premises) oraz należącego do użytkownika służbowego adresu e-mail SharePoint w wersji lokalnej. Jeśli używane jest to mapowanie, adresy e-mail użytkownika w obu systemach muszą być zgodne. Więcej informacji: Konfigurowanie mapowania oświadczeń użytkownika przy użyciu adresu e-mail SharePoint
Inne wymagania wstępne i ograniczenia
Cyfrowy certyfikat X509 używany do uwierzytelniania opartego na serwerze między Dynamics 365 Server a serwerem SharePoint. Klucze certyfikatów musi mieć co najmniej 2048-bitowe szyfrowanie. W większości przypadków ten certyfikat musi zostać wystawiony przez zaufany urząd certyfikacji, ale dla celów dokonania oceny można użyć certyfikatu z podpisem własnym.
Tożsamość puli aplikacji CRMAppPool musi mieć dostęp do odczytu do certyfikatu x509, który będzie używany do uwierzytelniania na serwerze z Dynamics 365 Server i serwerem SharePoint. Aby udzielić takiego dostępu, można użyć przystawki Certyfikaty w konsoli MMC.
Jeśli używasz Microsoft SharePoint 2013, dla każdej farmy SharePoint, tylko jedna organizacja Customer Engagement (on-premises) może być konfigurowana do integracji opartej na serwerze. Można połączyć więcej niż jedną organizację Customer Engagement (on-premises) z farmą serwerów SharePoint 2016.
Przygotuj Dynamics 365 Server do integracji opartej na serwerze
CertificateReconfiguration.ps1 to skrypt Windows PowerShell, który instaluje certyfikat do lokalnego magazynu certyfikatów, udziela określonego dostępu tożsamości usługi przetwarzania asynchronicznego Microsoft Dynamics 365 do certyfikatu, i aktualizuje Dynamics 365 Server do używania certyfikatu.
Dodaj certyfikat serwer do serwera do lokalnego magazynu certyfikatów i bazy danych konfiguracji Customer Engagement (on-premises)
- Otwórz sesję polecenia PowerShell na wszystkich serwerach, gdzie zainstalowano rolę Pełny serwer Dynamics 365 Server.
Ważne
Opisane w tym miejscu polecenie należy uruchomić na wszystkich serwerach, na których działa rola serwera aplikacji sieci Web.
Zmień lokalizację na folder <drive>:\Program Files\Microsoft Dynamics CRM\Tools.
Uruchom skrypt CertificateReconfiguration. ps1 Windows PowerShell, jak wyjaśniono tutaj:
certificateFilepath\Personalcertfile.pfx . Wymagany parametr, który określa pełną ścieżkę do pliku wymiany informacji osobistych (.pfx). Więcej informacji: Praca z certyfikatami cyfrowymi
passwordpersonal_certfile_password. Wymagany parametr, który określa hasło prywatnego certyfikatu.
certificateType S2STokenIssuer. Wymagany parametr, który określa typ certyfikatu. W przypadku opartej na serwerze integracji Customer Engagement (on-premises) i SharePoint obsługiwany jest tylko S2STokenIssuer.
serviceAccount ‘DomainName\UserName’ or ‘Network Service’.
serviceAccount 'contoso\\CRMWebAppServer' or ‘Network Service’. Required parameter that specifies the identity for the Web Application Server role. The identity is either a domain user account, such as *contoso\\CRMWebAppServer*, or Network Service. The identity will be granted permission to the certificate.updateCrm. Dodaje informacje o certyfikacie do bazy danych konfiguracji Microsoft Customer Engagement (on-premises).
Ważne
Nawet jeśli istnieje wiele wdrożonych ról Serwer aplikacji sieci Web lub Usługa asynchroniczna, wystarczy raz uruchomić polecenie przy użyciu parametru updateCrm.
storeFindType FindBySubjectDistinguishedName. Określa typ magazynu certyfikatu. Domyślnie ta wartość to FindBySubjectDistinguishedName i jest to wartość zalecana w przypadku uruchamiania skryptu.
Ważne
Chociaż parametry updateCrm i StoreFindType są opcjonalne dla uruchomienia polecenia, to parametry te są wymagane dla opartej na serwerze integracji z SharePoint, aby informacje o certyfikacie zostały dodane do bazy danych konfiguracji.
Przykład
.\CertificateReconfiguration.ps1 -certificateFile c:\Personalcertfile.pfx -password personal_certfile_password -updateCrm -certificateType S2STokenIssuer -serviceAccount Domain\UserName -storeFindType FindBySubjectDistinguishedName
Przygotuj farmę SharePoint do integracji opartej na serwerze
Pobierz identyfikator obszaru Dynamics 365
Uruchom Kreator opartej na serwerze integracji z SharePoint. Wybierz kolejno pozycje Ustawienia>Zarządzanie dokumentami.
Wybierz Dalej, wybierz Wersja lokalna, a następnie Dalej.
Identyfikator jest wyświetlany obok Identyfikator obszaru Dynamics 365 na stronie.
Napiwek
Zapisz identyfikator obszaru Dynamics 365 w pliku tekstowym w zabezpieczonym udziale sieciowym lub magazynie w chmurze. Będziesz je mógł z łatwością pobrać z lokalizacji, gdzie uruchamiasz Kreator opartej na serwerze integracji z SharePoint.
Na lokalnym serwerze SharePoint, w powłoce zarządzania SharePoint uruchom te polecenia PowerShell w podanej kolejności.
Przygotuj serwer SharePoint do uwierzytelniania z Dynamics 365 Server
Jeśli używasz powłoki zarządzania PowerShell, która nie jest powłoką zarządzania SharePoint, musisz zarejestrować moduł SharePoint przy użyciu poniższego polecenia.
Add-PSSnapin Microsoft.SharePoint.PowerShellWłącz sesję PowerShell, aby wprowadzić zmiany w usłudze tokenu zabezpieczającego dla farmy SharePoint.
$c = Get-SPSecurityTokenServiceConfig $c.AllowMetadataOverHttp = $true $c.AllowOAuthOverHttp= $true $c.Update()Utwórz obiekt zaufanej usługi tokenu zabezpieczającego, gdzie OrganizationName to unikatowa nazwa organizacji Customer Engagement (on-premises), a CrmServer to nazwa serwera sieci Web IIS, na którym zainstalowana została rola serwera aplikacji sieci Web Customer Engagement (on-premises), a -Nazwa “crm” jest używana, aby nazwać serwer tokenu zabezpieczającego (STS).
Ważne
-
Podłączanie więcej niż jednej organizacji Customer Engagement (on-premises) do jednej farmy serwera Microsoft SharePoint 2013 nie jest obsługiwane. Można połączyć więcej niż jedną organizację Customer Engagement (on-premises) z farmą serwerów SharePoint 2016.
-
Po uruchomieniu polecenia New-SPTrustedSecurityTokenIssuer PowerShell należy określić protokół HTTPS dla punktu końcowego metadanych Customer Engagement (on-premises) jeśli witryna sieci Web Customer Engagement (on-premises) ma tylko powiązania HTTPS lub powiązania HTTP i HTTPS, jest w poniższym przykładzie.
New-SPTrustedSecurityTokenIssuer –Name "crm" –IsTrustBroker:$false –MetadataEndpoint https://CrmServer/XrmServices/2015/metadataendpoint.svc/json?orgName=OrganizationName-
Zarejestruj Customer Engagement (on-premises) ze zbiorem witryn SharePoint.
Aby uruchomić poniższe polecenia musisz określić poniższe dwa parametry:
Adres URL zbioru witryn lokalnych SharePoint. W tym przykładzie
https://sharepoint.contoso.com/sites/crm/jest używany dla adresu URL zbioru witryn.CrmRealmId to identyfikator organizacji Customer Engagement (on-premises), którego chcesz użyć do zarządzania dokumentami z SharePoint. Więcej informacji: Pobierz identyfikator obszaru Dynamics 365
Ważne
Aby ukończyć te polecenia, musi istnieć i działać serwer proxy aplikacji zarządzania aplikacjami SharePoint. Aby uzyskać więcej informacji dotyczących sposobu uruchamiania i konfigurowania usługi, zobacz Konfigurowanie ustawień subskrypcji oraz temat Aplikacje usługi zarządzania aplikacją w Konfigurowanie środowiska dla aplikacji dla SharePoint .
$CrmRealmId = "CRMRealmId" $Identifier = "00000007-0000-0000-c000-000000000000@" + $CrmRealmId $site = Get-SPSite "https://sharepoint.contoso.com/sites/crm/" Register-SPAppPrincipal -site $site.RootWeb -NameIdentifier $Identifier -DisplayName "crm"Przyznaj Customer Engagement (on-premises) dostęp do witryny SharePoint.
Uwaga
W poniższym przykładzie Customer Engagement (on-premises) posiada uprawnienie do określonego zbioru witryny SharePoint dzięki użyciu parametru –Scope sitecollection. Parametr Zakres akceptuje następujące opcje. Użyj zakresu, który jest najbardziej odpowiedni dla Twojej konfiguracji SharePoint:
-
witryna. Udziela Customer Engagement (on-premises) uprawnienia tylko do określonej witryny sieci Web SharePoint. Nie udziela uprawnień do żadnych podwitryn witryny.
-
sitecollection. Udziela Customer Engagement (on-premises) uprawnienia do wszystkich witryn i podwitryn w określonym zbiorze witryn SharePoint.
-
sitesubscription. Udziela Customer Engagement (on-premises) uprawnienia do wszystkich witryn farmy programu SharePoint, włącznie z zbiorami witryn, witrynami i podwitrynami.
$app = Get-SPAppPrincipal -NameIdentifier $Identifier -Site $site.Rootweb Set-SPAppPrincipalPermission -AppPrincipal $app -Site $site.Rootweb -Scope "sitecollection" -Right "FullControl" -EnableAppOnlyPolicy #"Set up claims-based authentication mapping" New-SPClaimTypeMapping -IncomingClaimType "https://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress" -IncomingClaimTypeDisplayName "EmailAddress" -SameAsIncoming-
Uruchom Kreator opartej na serwerze integracji z SharePoint
W Customer Engagement (on-premises) przejdź do Ustawienia>Zarządzanie dokumentami.
W obszarze Zarządzanie dokumentami wybierz Włącz opartą na serwerze integrację SharePoint.
Przejrzyj informacje, a następnie wybierz Dalej.
Dla witryn SharePoint wybierz Lokalne, a następnie wybierz Dalej.
Na etapie Przygotowywanie witryn, wprowadź poniższe informacje:
Zbiór witryn lokalnych SharePoint, Adres URL, taki jak https://sharepoint.contoso.com/sites/crm. Witryna musi być skonfigurowana dlaTLS/SSL.
Identyfikator obszaru SharePoint. Pobierz identyfikator obszaru SharePoint
Wybierz Dalej.
Pojawia się sekcja sprawdzania poprawności witryny. Jeśli wszystkie witryny są prawidłowe, wybierz Włącz. Jeśli jedna lub kilka witryn są nieprawidłowe, zobacz Rozwiązywanie problemów związanych z opartą na serwerze integracją lokalnego Dynamics 365 Server z serwerem SharePoint.
Wybierz encje, które chcesz dołączyć do zarządzania dokumentami
Domyślnie dołączone są encje takie jak Konto, Artykuł, Potencjalny klient, Produkt, Oferta i Materiały sprzedażowe. Możesz dodawać lub usuwać encje, które będą używane do zarządzania dokumentami z SharePoint w Ustawienia zarządzania dokumentami dla aplikacji Customer Engagement. Wybierz kolejno pozycje Ustawienia>Zarządzanie dokumentami. Więcej informacji: Włącz zarządzanie dokumentami SharePoint dla konkretnych encji.
Dodaj integrację OneDrive dla Firm
Po zakończeniu konfiguracji uwierzytelniania na serwerze dla Customer Engagement (on-premises) i SharePoint (wersja lokalna) możesz również zintegrować OneDrive dla Firm. Dzięki integracji Customer Engagement (on-premises) OneDrive dla Firm użytkownicy Customer Engagement (on-premises) mogą tworzyć i zarządzać prywatnymi dokumentami przy użyciu OneDrive dla Firm. Dokumenty te są dostępne w ramach Customer Engagement (on-premises) po tym jak administrator systemu włączył OneDrive dla Firm.
Włącz usługę OneDrive dla Firm
W Windows Server, gdzie działa SharePoint Server (wersja lokalna) otwórz powłokę zarządzania SharePoint i uruchom poniższe polecenia.
Add-Pssnapin *
# Access WellKnown App principal
[Microsoft.SharePoint.Administration.SPWebService]::ContentService.WellKnownAppPrincipals
# Create WellKnown App principal
$ClientId = "00000007-0000-0000-c000-000000000000"
$PermissionXml = "<AppPermissionRequests AllowAppOnlyPolicy=""true""><AppPermissionRequest Scope=""https://sharepoint/content/tenant"" Right=""FullControl"" /><AppPermissionRequest Scope=""https://sharepoint/social/tenant"" Right=""Read"" /><AppPermissionRequest Scope=""https://sharepoint/search"" Right=""QueryAsUserIgnoreAppPrincipal"" /></AppPermissionRequests>"
$wellKnownApp= New-Object -TypeName "Microsoft.SharePoint.Administration.SPWellKnownAppPrincipal" -ArgumentList ($ClientId, $PermissionXml)
$wellKnownApp.Update()
Rozwiązywanie problemów z opartą na serwerze integracją Customer Engagement (on-premises) z SharePoint Server
Aby uzyskać informacje na temat rozwiązywania problemów dotyczących włączania kreatora opartej na serwerze integracji SharePoint i przeglądania dzienników monitorowania SharePoint zobacz Rozwiązywanie problemów z uwierzytelnianiem opartym na serwerze.
Znane problemy
Aby uzyskać informacje o rozwiązywaniu problemów i znanych problemach dotyczących zarządzania dokumentami SharePoint, zobacz Rozwiązywanie problemów z uwierzytelnianiem opartym na serwerze.
Informacje o mapowaniu uwierzytelniania opartego na oświadczeniach
W przypadku mapowania uwierzytelniania opartego na oświadczeniach domena usługi Active Directory, w której zlokalizowane są serwer SharePoint i Dynamics 365 Server muszą być takie same. Serwery zlokalizowane w różnych lasach lub domenach usługi Active Directory nie są obsługiwane. Podobnie użytkownicy, którzy znajdują się w domenach zewnętrznych do serwera Dynamics 365 Server lub SharePoint Server nie będą mieli dostępu do dokumentów.
Domyślnie oparte na serwerze uwierzytelnianie między Customer Engagement (on-premises) a SharePoint (wersja lokalna) za pomocą identyfikatora zabezpieczeń użytkownika (SID) uwierzytelnia wszystkich użytkowników. Jeśli chcesz użyć niestandardowego mapowania uwierzytelniania opartego na oświadczeniach, na przykład adresu e-mail użytkownika, zobacz Definiowanie niestandardowego mapowania oświadczeń dla opartej na serwerze integracji SharePoint
Konfigurowanie mapowania oświadczeń użytkownika przy użyciu adresu e-mail SharePoint
Otwórz edytor formularzy, aby dostosować formularz użytkownika. Aby to zrobić, przejdź do Ustawienia>Zabezpieczenia>Użytkownicy, a następnie otwórz żądany rekord użytkownika.
Na pasku narzędzi wybierz ... a następnie wybierz Edytor formularza.
Znajdź pole Adres e-mail SharePoint w okienku Eksplorator pól i przeciągnij je i upuść w sekcji Informacje o użytkowniku formularza użytkownika.
Na pasku narzędzi edytora formularza, wybierz Zapisz i wybierz Publikuj.
Zamknij edytor formularzy i odśwież kartę przeglądarki sieci Web, aby wyświetlić nowo dodane pole rekordu użytkownika.
W polu adres e-mail rekordu użytkownika SharePoint wprowadź adres e-mail użytkownika w taki sam sposób, w jaki jest wyświetlany w SharePoint.
Wybierz pozycję Zapisz.
Powtórz poprzednie dwa kroki dla wszystkich użytkowników, którzy będą potrzebować zarządzania dokumentami.
Praca z certyfikatami cyfrowymi
Poniższa procedura tworzy plik wymiany informacji osobistych (pfx).
Na komputerze, który ma dostęp do certyfikatu, który ma być używany do przeprowadzania uwierzytelniania pomiędzy serwerami wybierz Start, wybierz Uruchom, wpisz MMC, i naciśnij Enter.
Wybierz Plik, a następnie wybierz Dodaj/Usuń przystawkę.
Na liście dostępnych przystawek wybierz Certyfikaty, wybierz Dodaj, wybierz Konto komputera, wybierz Dalej, wybierz Zakończ, aby wybrać komputer lokalny, a następnie wybierz OK.
Rozwiń Certyfikaty, rozwiń Osobiste, a następnie wybierz Certyfikaty.
Kliknij prawym przyciskiem myszy certyfikat, którego chcesz użyć w celu utworzenia pliku certyfikatu osobistego, wskaż Wszystkie zadania, a następnie wybierz Eksportuj.
Wybierz Dalej, wybierz Tak, aby wyeksportować klucz prywatny, upewnij się, że zostały zaznaczone poniższe opcje, a następnie wybierz Dalej.
Jeśli to możliwe, dołącz wszystkie certyfikaty do ścieżki certyfikacji
Eksportuj wszystkie właściwości rozszerzone
Wybierz Przeglądaj i wprowadź lokalizację i nazwę pliku dla pliku .pfx, a następnie wybierz Zapisz.
Wybierz Dalej, a następnie wybierz Koniec.
Pobierz identyfikator obszaru SharePoint
Uruchom następujące polecenia PowerShell w Powłoce zarządzania SharePoint, gdzie https://sharepoint.contoso.com/sites/crm/ to adres URL dla zbioru witryn SharePoint.
Get-SPAuthenticationRealm -ServiceContext https://sharepoint.contoso.com/sites/crm/
Alternatywnie, możesz znaleźć identyfikator obszaru SharePoint w ustawieniach uprawnień aplikacji witryny dla zbioru witryn SharePoint.
Zaloguj się do zbioru witryn SharePoint, którego będziesz używał do zarządzania dokumentami z Customer Engagement (on-premises).
Przejdź do Ustawienia witryny>Uprawnienia aplikacji witryny.
Identyfikator obszaru jest wyświetlany w obszarze Identyfikator aplikacji, po prawej stronie znaku @. Skopiuj go do Schowka. W kreatorze Włącz opartą na serwerze integrację z SharePoint wklej GUID. Nie wklejaj żadnej części identyfikatora z lewej strony znaku @.