Conector de SharePoint sharepoint-connector
Este artículo incluye detalles sobre el conector JCR de Adobe para Microsoft SharePoint 2010 y Microsoft SharePoint 2013, versión 4.0.
El conector SharePoint admite las siguientes funcionalidades básicas:
- Lectura de contenido y metadatos desde SharePoint.
- Reconocimiento de la configuración de seguridad de SharePoint para el contenido accedido mediante la aplicación de la autenticación y autorización nativas de SharePoint
- Integración de contenido mediante el buscador de contenido
- AEM Uso de componentes de, como Recurso externo, para mostrar imágenes y vídeos de SharePoint
- Sincronización de SharePoint con AEM Assets
Todas las funcionalidades se implementan utilizando los servicios web nativos de SharePoint como interfaz para el contenido y los servicios de SharePoint.
Introducción getting-started
Para empezar a usar el conector, haga lo siguiente:
-
Asegúrese de que tiene instalado al menos Java 7.
-
Descargue el archivo de distribución del paquete del conector desde Distribución de software.
-
Copie un archivo license.properties válido en el directorio que contiene el archivo cq-quickstart-6.4.0.jar.
-
AEM Haga doble clic en el archivo .jar para iniciarlo o iniciarlo desde la línea de comandos.
-
Instale el paquete del conector desde el Administrador de paquetes.
-
Configure las opciones del conector.
Instalación del conector de SharePoint installing-sharepoint-connector
El conector es un paquete de contenido que facilita la instalación. Instale el paquete mediante el Administrador de paquetes y, a continuación, defina la URL del servidor de SharePoint
y otras opciones de configuración. El contenido de SharePoint AEM está disponible en el repositorio de.
Requisitos de instalación installation-requirements
El conector requiere lo siguiente:
- Java Runtime Environment 1.7 o posterior
- Servicios web de SharePoint disponibles a través de la red
- URL del servidor de SharePoint
- Credenciales y permisos de usuario para repositorios de CRX y SharePoint
- Plataformas compatibles
El conector SharePoint está disponible para su descarga desde Distribución de software.
Plataformas compatibles supported-platforms
El conector admite lo siguiente:
-
AEM Versiones de:
- AEM.4, 6.3
-
Versiones de Microsoft SharePoint:
- Microsoft Office SharePoint Server (MOSS) 2010
- Microsoft Office SharePoint Server (MOSS) 2013
-
Si necesita soporte para implementaciones personalizadas del conector (OEM, requisitos especiales, métodos de autenticación personalizados), póngase en contacto con la oficina de Adobe de su región.
Instalación estándar standard-installation
Distribución de software se utiliza para distribuir funciones de productos, ejemplos y correcciones rápidas. Para obtener más información, consulte la documentación de distribución de software.
AEM Integración con la integrating-with-aem
Para instalar el paquete de contenido del conector.
-
Abra un ticket de soporte de Adobe para solicitar el paquete de funciones del conector.
-
AEM Descargue el paquete cuando esté disponible y, a continuación, abra el Administrador de paquetes para la instancia de la.
-
Haga clic en Instalar en la página de descripción del paquete.
-
En el cuadro de diálogo Instalar paquete, haga clic en Instalar.
Nota: Asegúrese de haber iniciado sesión como administrador.
-
Cuando el paquete esté instalado, haga clic en Cerrar.
Configuración del conector de SharePoint configuring-sharepoint-connector
Después de instalar el conector de SharePoint, configure las capas de la aplicación y de SharePoint para el conector.
Establezca la URL del servidor de SharePoint para que el repositorio de SharePoint sea compatible con JCR. Puede definir parámetros adicionales para configurar la conexión con el servidor de SharePoint. Además, configure la autenticación con el conector de SharePoint.
Configuración de la conexión con el servidor de SharePoint configuring-the-connection-with-the-sharepoint-server
Para establecer la dirección URL del servidor de SharePoint y las opciones avanzadas, realice estos pasos:
- Vaya a la consola de administración de OSGi: http://localhost:4502/system/console/configMgr.
- Busque el paquete Day JCR Connector for Microsoft Sharepoint.
- Edite los valores de configuración.
- Establezca la URL del servidor de SharePoint como el valor de Workspaces.
- Haga clic en Guardar.
Parámetros "Workspaces" y "Nombre de Workspace predeterminado":
De forma predeterminada, el conector expone un solo espacio de trabajo JCR. El servidor de SharePoint que expone este espacio de trabajo se establece mediante el parámetro de configuración "URL del servidor de SharePoint".
El conector también se puede configurar para varios espacios de trabajo. En este caso, cada espacio de trabajo está asociado con la dirección URL del servidor de SharePoint correspondiente que se expone a través del espacio de trabajo. Para agregar un espacio de trabajo, agregue una definición de espacio de trabajo al parámetro Workspaces. Una definición de espacio de trabajo tiene el siguiente formato:<name>= <url> donde<name> es el nombre del espacio de trabajo JCR y<url> es la dirección URL del servidor de SharePoint para ese espacio de trabajo.
AEM En, realice un paso más aparte de los pasos de configuración anteriores. Lista de permitidos el paquete 'com.day.cq.dam.cq-dam-jcr-connectors'.
Para realizar la lista de permitidos AEM de paquetes en la, realice los siguientes pasos:
- Vaya a la consola de administración de OSGi: http://localhost:4502/system/console/configMgr.
- Busque el servicio "Lista blanca de administración de inicio de sesión de Apache Sling".
- Seleccione Omitir la lista blanca.
- Agregar
com.day.cq.dam.cq-dam-jcr-connectorsen los paquetes de la lista blanca de forma predeterminada - Haga clic en Guardar.
Para obtener información adicional acerca de los parámetros relacionados con la autenticación, consulte Autenticación.
Verificar la configuración de Sharepoint verifying-the-sharepoint-setup
Después de configurar el conector, compruebe lo siguiente:
- Se ejecuta el servidor de SharePoint y la instancia del conector puede acceder a los servicios web
- Las credenciales de usuario de SharePoint son válidas y el usuario tiene los permisos de SharePoint necesarios
- El conector está instalado y configurado correctamente
Configuración de la sincronización DAM con el servidor de SharePoint configuring-dam-sync-with-the-sharepoint-server
Para sincronizar el SharePoint Assets AEM con el usuario, realice los siguientes pasos:
- Vaya a la consola de administración de OSGi: http://localhost:4502/system/console/configMgr.
- Busque el servicio "Default DAMAsetSynchronization".
- Edite los valores de configuración.
- Configure el nombre de usuario y la contraseña correspondientes del usuario que tiene acceso al sitio de SharePoint.
- Haga clic en Guardar.
Habilitar el servicio de sincronización DAM, que está deshabilitado de forma predeterminada:
- Vaya a los componentes de la consola web de OSGi: http://localhost:4502/system/console/components
- Busque "com.day.cq.dam.jcrconnectors.impl.AssetSynchronizationService".
- Haga clic en Habilitar.
De forma opcional, puede configurar la Demora de sincronización entre diferentes ciclos de sincronización:
- Vaya a la consola de administración de OSGi: http://localhost:4502/system/console/configMgr
- Busque "DAY CQ DAM JCR Connector Asset Synchronization Service".
- Edite los valores de configuración.
- Establezca el valor del Período de sincronización (en segundos).
- Haga clic en Guardar.
Configurar la autenticación configuring-authentication
Sharepoint incluye los métodos de autenticación Classic y Claims Based, que admiten los siguientes tipos de autenticación:
- Básica
- Basado en Forms
En particular, están disponibles los siguientes tipos de autenticación:
- Classic-Basic
- Basado en Forms clásico
- Reclamaciones básicas
- Argumentos basados en Forms
AEM El conector JCR de la aplicación para Microsoft SharePoint 2010 y Microsoft SharePoint 2013, versión 4.0. admite la autenticación basada en notificaciones (sugerida por Microsoft), que funciona de los siguientes modos:
- Autenticación básica/NTLM: El conector intenta conectarse primero mediante la autenticación básica. Si no está disponible, cambia a la autenticación basada en NTLM.
- Autenticación basada en Forms: Sharepoint valida a los usuarios basándose en las credenciales que los usuarios escriben en un formulario de inicio de sesión (normalmente una página web). El sistema emite un token para solicitudes autenticadas que contiene una clave para restablecer la identidad en solicitudes posteriores.
Configuración de la autenticación basada en Forms
Ir a: http://localhost:4502/system/console/bundles
- Haga clic en OSGI > Configuración
- Buscar "Conector JCR de día para Microsoft Sharepoint"
- Haga clic en Editar los valores de configuración.
- Establezca el valor de 'Sharepoint Connection Factory' como 'com.day.crx.spi.sharepoint.security.FormsBasedAuthenticationConnectionFactory'
- Haga clic en Guardar.
Configuración de la autenticación básica (Windows)
- Deshabilitar autenticación de token.
- Vaya a http://localhost:4502/system/console/bundles.
- Haga clic en OSGI > Configuración.
- Busque Day JCR Connector for Microsoft Sharepoint.
- Haga clic en
Edit the configuration values. - Establezca el valor de la Fábrica de conexiones de Sharepoint en
com.day.crx.spi.sharepoint.security.WindowsAuthenticationConnectionFactory. - Haga clic en Guardar.
AEM Solo un usuario autenticado tanto en el usuario como en el SharePoint puede acceder al contenido de SharePoint a través del conector.
AEM También puede utilizar la extensión del conector para la autenticación con el fin de crear un módulo de autenticación personalizado que, por ejemplo, asigne el acceso de los usuarios de a usuarios específicos de SharePoint. AEM Cree los usuarios correspondientes de SharePoint (el nombre de usuario y la contraseña deben coincidir) para poder ver el contenido de SharePoint asignado a la instancia del conector.
AEM Para crear un usuario en el entorno de trabajo de:
- Inicie sesión en http://localhost:9502/with el usuario administrador.
- Haga clic en Herramientas.
- Haga clic en Seguridad.
- Haga clic en Usuarios.
- Haga clic en Crear usuario.
- Proporcione el ID de usuario (nombre de usuario con acceso en SharePoint).
- Proporcione la contraseña correspondiente.
- Haga clic en el símbolo de graduación Verde para crear el usuario.
Para agregar el usuario al grupo de administradores:
- Vaya a Administración de grupos.
- Haga clic en el nodo "a".
- Haga clic en "administradores".
- Escriba el identificador de usuario creado anteriormente en el cuadro de texto antes del botón Examinar.
- Haga clic en el símbolo de verificación verde para añadir al usuario al grupo de administradores.
Deshabilitar autenticación de token disable-token-authentication
-
Descargue e instale el paquete
basic auth.zipde Distribución de software. -
Cerrar inicio rápido.
-
Abra el archivo \crx-quickstart\repository\repository.xml.
-
Buscar la etiqueta
<LoginModule class="com.day.crx.core.CRXLoginModule"> ... </LoginModule>. -
Inserte la etiqueta
<param name="disableTokenAuth" value="true"/>dentro de la etiqueta mencionada en el paso 4. -
Guarde y cierre el archivo xml.
-
Reinicie QuickStart e inicie sesión con sus credenciales.
Compatibilidad con distintos métodos de autenticación del servidor de SharePoint supporting-different-authentication-methods-of-the-sharepoint-server
En su versión estándar, el conector admite la autenticación estándar de IIS Windows (básica) y la autenticación basada en Forms (basada en token). Se pueden admitir otros métodos de autenticación a través del mecanismo de extensibilidad.
Los siguientes pasos proporcionan directrices para ampliar la autenticación estándar para admitir varios métodos de autenticación del servidor de SharePoint:
-
Implemente
com.day.crx.spi.sharepoint.security.SharepointConnectionFactorypara controlar el lado del cliente de su proceso de autenticación específico. -
Instale la implementación
SharepointConnectionFactorycomo un paquete de fragmentos con el host de fragmentoscom.day.crx.spi.crx2sharepoint-bundle.Al usar Maven, adapte la siguiente configuración de
maven-bundle-plugina los requisitos de su proyecto:code language-xml <plugin> <groupId>org.apache.felix</groupId> <artifactId>maven-bundle-plugin</artifactId> <extensions>true</extensions> <configuration> <instructions> <Export-Package /> <Private-Package> <!-- your private package here --> </Private-Package> <Fragment-Host> com.day.crx.spi.crx2sharepoint-bundle </Fragment-Host> </instructions> </configuration> </plugin> -
Registre la implementación
SharepointConnectionFactoryen la configuración del conector. En la ventana de configuración del conector, haga clic en Opciones avanzadas. En el campo para Sharepoint Connection Factory, especifique el nombre de la implementacióncom.day.crx.spi.sharepoint.auth.CustomConnectionFactory. -
Reinicie el conector.