Diferencia entre revisiones de «Servicio OAuth 2 Nextcloud»

De MoodleDocs
(tidy up)
(Updated as per 3.6 page)
 
(No se muestran 6 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
{{OAuth2}}{{Nuevas características de Moodle 3.6}}
{{OAuth2}}{{Nuevas características de Moodle 3.6}}
{{EnTraduccion}}
{{Notadeltraductor|Actualmente (noviembre 2018) la página web de [https://nextcloud.com/ Nextcloud] solamente está disponible en idiomas inglés y alemán, pero no en español.}}
 


== Configuración de Nextcloud ==  
== Configuración de Nextcloud ==  


As a prerequisite, you need Nextcloud in version 14.0.4 (or above). Otherwise, please [https://docs.nextcloud.com/server/14/admin_manual/maintenance/upgrade.html upgrade to a recent Nextcloud version] first. Then you need to [https://docs.nextcloud.com/server/14/admin_manual/configuration_server/oauth2.html#add-an-oauth2-application register Moodle as an OAuth 2 client] as follows:
Como un pre-requisito, Usted necesita Nextcloud en versión 14.0.4 (o superior). En caso contrario, por favor [https://docs.nextcloud.com/server/14/admin_manual/maintenance/upgrade.html actualice a una versión más reciente de Nextcloud] primero. Después Usted necesitará [https://docs.nextcloud.com/server/14/admin_manual/configuration_server/oauth2.html#add-an-oauth2-application registrar Moodle como un cliente de OAuth 2] como sigue:


# Log in to Nextcloud using the administrator account.
# Ingrese a Nextcloud usando la cuenta de administrador.
# Open the menu in the top-right corner and select '''Settings'''. On the next page, select the '''Security''' item in the "Administration" section on the left. <br>[[File:nextcloud-oauth2-settings.png|100px]]
# Abra el menú en la esquina superior derecha y seleccione '''Settings''' (Ajustes). En la página siguiente, seleccione el ítem de seguridad '''Security''' en la sección sobre Administración "Administration" a la izquierda. <br>[[File:nextcloud-oauth2-settings.png|100px]]
# At the top of the next page you see the list of registered clients (which is empty initially). Below "Add client", enter the name of your Moodle (e.g., "Mount Orange School Moodle") in the first field (Name). Note that the name that you enter here will be displayed to your Moodle users.
# En la parte superior de la página siguiente Usted ve la lista de clientes registrados (la cual inicialmente está vacía). Debajo de Añadir cliente "Add client", ingrese el nombre de su Moodle (como por ejemplo, "Mount Orange School Moodle") en el primer campo de nombre (Name). Tenga en cuenta que el nombre que Usted ingrese aquí será mostrado a sus usuarios Moodle.
# In the second field (Redirection URI), enter the URL of your Moodle followed by '''/admin/oauth2callback.php''' (e.g., "<nowiki>https://school.demo.moodle.net/admin/oauth2callback.php</nowiki>").
# En el segundo campo (Redirection URI), ingrese la URL de su Moodle seguida por '''/admin/oauth2callback.php''' (por ejemplo, "<nowiki>https://school.demo.moodle.net/admin/oauth2callback.php</nowiki>").
# Click '''Add''' to save. Afterwards, the page looks similar to the screenshot below.
# Haga click en añadir '''Add''' para guardar. Después, la página se ve similar a la imagen de pantalla inferior.


[[File:nextcloud-moodle-client.png|none|frame|Registration of Moodle as an OAuth 2 client in Nextcloud]]
[[File:nextcloud-moodle-client.png|none|frame|Registro de Moodle como un cliente de OAuth 2 en Nextcloud]]


Moodle is now allowed to connect to Nextcloud using OAuth 2 authentication.
Moodle tiene ahora permitido el conectar a Nextcloud usando la autenticación OAuth 2.


== Configuración de Moodle ==
== Configuración de Moodle ==
Después de que Usted haya hecho la [[#Nextcloud configuration|configuración de Nextcloud]], Usted puede configurar Moodle.


After you have [[#Nextcloud configuration|set up Nextcloud]], you can configure Moodle.
# Ir a ''Administración del sitio > Servidor > Servicios OAuth 2'' y haga click en  '''Crear nuevo servicio Nextcloud'''.
# En la página siguiente, ingrese el nombre '''Name''' de su Nextcloud, la ID del cliente '''Client ID''' y su secreto '''Client secret''' (como se observa en la interfase de administración de Nextcloud en la imagen de pantalla de arriba) y la '''Service base URL''' que es la URL de su Nextcloud. Si Usted usa un '''Logo''' Nexcloud personalizado, especifique su URL también.<br>[[File:nextcloud-issuer-settings.png|400px]]  
# Usted no necesita cambiar ninguna otra configuración. Haga click en '''Guardar cambios (Save changes)'''.


# Go to ''Site administration > Server > OAuth 2 services'' and click '''Create new Nextcloud service'''.
Después, Usted puede usar el servicio Nextcloud desde su Moodle, por ejemplo, desde el [[Repositorio Nextcloud]].
# On the next page, enter the '''Name''' of your Nextcloud, the '''Client ID''' and '''Client secret''' (as seen in the Nextcloud admin interface in the screenshot above) and the '''Service base URL''' which is the URL of your Nextcloud. If you use a custom Nextcloud '''Logo''', specify its URL, too.<br>[[File:nextcloud-issuer-settings.png|400px]]
# You do not need to change any other settings. Click '''Save changes'''.
 
Afterwards, you can use the Nextcloud service from your Moodle, for example from the [[Repositorio Nextcloud]].


[[File:nextcloud-issuer-configured.png|none]]
[[File:nextcloud-issuer-configured.png|none]]
Línea 32: Línea 30:
== Solución de problemas ==
== Solución de problemas ==


There are some configuration mistakes that might prevent Moodle from communicating with Nextcloud properly. Some of them are due to the fact that you can host Nextcloud on your own and that it is easy to make mistakes that are hard to spot at first. However, this list will help you resolve them.
Hay algunos errores de configuración que podrían impedir que Moodle se comunique con Nextcloud apropiadamente. Algunos de ellos se deben al hecho de que Usted mismo puede alojar Nextcloud por su cuenta y es fácil cometer errores que son difíciles de identificar a la primera. Sin embargo, esta lista le ayudará a resolverlos.
 
; I cannot connect a system account. : Log out from Nextcloud first. Make sure the Nextcloud account that you want to connect as a system account is different from all personal accounts. It has to be an account that belongs to Moodle, not to a person. Also, check the issuer settings. The checkbox '''Authenticate token requests via HTTP headers''' must be enabled!
; Authentication seems to have succeeded, but the filepicker shows "There are no files". : It is possible that HTTPS is not configured correctly on the Nextcloud end. You need a ''valid'' and ''trusted'' certificate for your Nextcloud server! A self-signed certificate will not work. Unlike in the browser, you cannot manually "trust" a self-signed server certificate.
; After signing in with Nextcloud I get an error that says "This request is not valid. Please contact the administrator of [your Moodle Name] if this error persists.". : You might have entered the wrong ''Redirect URI'' in Nextcloud. It is important that it ends with '''/admin/oauth2callback.php''' and that it corresponds '''exactly''' to the URL that Moodle is going to send to Nextcloud when attempting to authenticate!
; When I access an access controlled link I authorise Moodle but then cannot see the file. : In older Nextcloud versions (prior to 14.0.1), when you authorise Moodle, your Nextcloud browser session ends. Upgrade to a recent Nextcloud version (see [[#Nextcloud configuration]]) to resolve this.
; Since I connected a system account, Moodle is very slow : Nextcloud has a brute-force protection that was somewhat naïve (prior to 14.0.3). When enabled, it slows down some Moodle requests in some cases (even though the Moodle plugin is definitely not going to brute-force your Nextcloud!). First, upgrade to a recent Nextcloud version (see [[#Nextcloud configuration]]) to resolve this. As an additional measure, you can download the [https://apps.nextcloud.com/apps/bruteforcesettings "Brute-force settings" app for Nextcloud]. After installation, add the IP of your Moodle server to the whitelist.


; No me puedo conectar a una cuenta del sistema. : Primeramente sálgase de Nextcloud. Asegúrese de que la cuenta Nextcloud a la cual Usted desea conectar como una cuenta del sistema sea diferente de todas las cuentas personales. Tiene que ser una cuenta que pertenezca a Moodle, no a una persona. También, revise las configuraciones del emisor. ¡La casilla para Autenticar solicitudes de token vía encabezados HTTP  '''Authenticate token requests via HTTP headers''' debe estar habilitada!
; Parece que la autenticación funcionó, pero el selector de archivos me muestra que "No hay archivos". : Es posible que [[HTTPS]] no esté configurado correctamente en la parte de Nextcloud. ¡Usted necesita un certificado ''válido'' y ''confiable'' para su servidor Nextcloud! Un certificado firmado por Usted mismo no funcionará. A diferencia de lo que pasa en un navegador, Usted no puede manualmente "confiar" en un certificado de servidor auto-firmado. Usted también debería revisar quelos módulos de Apache "rewrite", "headers" y "env" estén instalados y habilitados en el servidor Nextcloud.
; Después de ingresar con Nextcloud me sale un  error que dice que esta solicitud no es válida y que debo ponerme en contacto con el administrador de [su Nombre Moodle] si este error persiste  "This request is not valid. Please contact the administrator of [your Moodle Name] if this error persists.". : Es posible que Usted haya ingresado una ''Redirect URI'' incorrecta en Nextcloud. ¡Es importante que termine con '''/admin/oauth2callback.php''' y que corresponda '''exactamente''' a la URL que Moodle va a enviar a Nextcloud cuando intente autenticar!
; Cuando yo accedo a un enlace de acceso controlado yo autorizo a Moodle pero no puedo ver el archivo. : En versiones antiguas de Nextcloud (anteriores a 14.0.1), cuando Usted autoriza a Moodle, se termina su sesión del navegador en Nextcloud. Actualice a una versión reciente de Nextcloud (vea [[#Configuración de Nextcloud]]) para resolver esto.
; Desde que conecté una cuenta del sistema, Moodle está  muy lento : Nextcloud tiene una protección de fuerza bruta que era bastante ingenua (anterior a 14.0.3). Cuando se habilitaba, alentaba algunas solicitudes Moodle en algunos casos (¡aunque el plugin de Moodle definitivamente no va a forzar a lo bruto a su Nextcloud!). Primeramente, actualice a una versión reciente de Nextcloud (vea [[#Configuración de Nextcloud]]) para resolver esto. Como una medida adicional, Usted puede descargar la [https://apps.nextcloud.com/apps/bruteforcesettings "Brute-force settings" app for Nextcloud]. Después de la instalación, añada la IP de su servidor Moodle a la lista blanca (''whitelist'').
; Cuando intento crear un enlace de acceso controlado me sale un error de que no puedo descargar este archivo  "Cannot download this file". : Estopuede pasar si la cuenta del sistema no está conectada. Vaya a ''Administración del sitio > Servidor > Servicios OAuth 2'' e intente conectar nuevamente la cuenta del sistema de Nextcloud.


[[en:OAuth 2 Nextcloud service]]
[[en:OAuth 2 Nextcloud service]]

Revisión actual - 17:45 27 nov 2018

¡Nueva característica
en Moodle 3.6!

translator note icon.png Nota del traductor: Actualmente (noviembre 2018) la página web de Nextcloud solamente está disponible en idiomas inglés y alemán, pero no en español.


Configuración de Nextcloud

Como un pre-requisito, Usted necesita Nextcloud en versión 14.0.4 (o superior). En caso contrario, por favor actualice a una versión más reciente de Nextcloud primero. Después Usted necesitará registrar Moodle como un cliente de OAuth 2 como sigue:

  1. Ingrese a Nextcloud usando la cuenta de administrador.
  2. Abra el menú en la esquina superior derecha y seleccione Settings (Ajustes). En la página siguiente, seleccione el ítem de seguridad Security en la sección sobre Administración "Administration" a la izquierda.
    nextcloud-oauth2-settings.png
  3. En la parte superior de la página siguiente Usted ve la lista de clientes registrados (la cual inicialmente está vacía). Debajo de Añadir cliente "Add client", ingrese el nombre de su Moodle (como por ejemplo, "Mount Orange School Moodle") en el primer campo de nombre (Name). Tenga en cuenta que el nombre que Usted ingrese aquí será mostrado a sus usuarios Moodle.
  4. En el segundo campo (Redirection URI), ingrese la URL de su Moodle seguida por /admin/oauth2callback.php (por ejemplo, "https://school.demo.moodle.net/admin/oauth2callback.php").
  5. Haga click en añadir Add para guardar. Después, la página se ve similar a la imagen de pantalla inferior.
Registro de Moodle como un cliente de OAuth 2 en Nextcloud

Moodle tiene ahora permitido el conectar a Nextcloud usando la autenticación OAuth 2.

Configuración de Moodle

Después de que Usted haya hecho la configuración de Nextcloud, Usted puede configurar Moodle.

  1. Ir a Administración del sitio > Servidor > Servicios OAuth 2 y haga click en Crear nuevo servicio Nextcloud.
  2. En la página siguiente, ingrese el nombre Name de su Nextcloud, la ID del cliente Client ID y su secreto Client secret (como se observa en la interfase de administración de Nextcloud en la imagen de pantalla de arriba) y la Service base URL que es la URL de su Nextcloud. Si Usted usa un Logo Nexcloud personalizado, especifique su URL también.
    nextcloud-issuer-settings.png
  3. Usted no necesita cambiar ninguna otra configuración. Haga click en Guardar cambios (Save changes).

Después, Usted puede usar el servicio Nextcloud desde su Moodle, por ejemplo, desde el Repositorio Nextcloud.

nextcloud-issuer-configured.png


Solución de problemas

Hay algunos errores de configuración que podrían impedir que Moodle se comunique con Nextcloud apropiadamente. Algunos de ellos se deben al hecho de que Usted mismo puede alojar Nextcloud por su cuenta y es fácil cometer errores que son difíciles de identificar a la primera. Sin embargo, esta lista le ayudará a resolverlos.

No me puedo conectar a una cuenta del sistema.
Primeramente sálgase de Nextcloud. Asegúrese de que la cuenta Nextcloud a la cual Usted desea conectar como una cuenta del sistema sea diferente de todas las cuentas personales. Tiene que ser una cuenta que pertenezca a Moodle, no a una persona. También, revise las configuraciones del emisor. ¡La casilla para Autenticar solicitudes de token vía encabezados HTTP Authenticate token requests via HTTP headers debe estar habilitada!
Parece que la autenticación funcionó, pero el selector de archivos me muestra que "No hay archivos".
Es posible que HTTPS no esté configurado correctamente en la parte de Nextcloud. ¡Usted necesita un certificado válido y confiable para su servidor Nextcloud! Un certificado firmado por Usted mismo no funcionará. A diferencia de lo que pasa en un navegador, Usted no puede manualmente "confiar" en un certificado de servidor auto-firmado. Usted también debería revisar quelos módulos de Apache "rewrite", "headers" y "env" estén instalados y habilitados en el servidor Nextcloud.
Después de ingresar con Nextcloud me sale un error que dice que esta solicitud no es válida y que debo ponerme en contacto con el administrador de [su Nombre Moodle] si este error persiste "This request is not valid. Please contact the administrator of [your Moodle Name] if this error persists.".
Es posible que Usted haya ingresado una Redirect URI incorrecta en Nextcloud. ¡Es importante que termine con /admin/oauth2callback.php y que corresponda exactamente a la URL que Moodle va a enviar a Nextcloud cuando intente autenticar!
Cuando yo accedo a un enlace de acceso controlado yo autorizo a Moodle pero no puedo ver el archivo.
En versiones antiguas de Nextcloud (anteriores a 14.0.1), cuando Usted autoriza a Moodle, se termina su sesión del navegador en Nextcloud. Actualice a una versión reciente de Nextcloud (vea #Configuración de Nextcloud) para resolver esto.
Desde que conecté una cuenta del sistema, Moodle está muy lento
Nextcloud tiene una protección de fuerza bruta que era bastante ingenua (anterior a 14.0.3). Cuando se habilitaba, alentaba algunas solicitudes Moodle en algunos casos (¡aunque el plugin de Moodle definitivamente no va a forzar a lo bruto a su Nextcloud!). Primeramente, actualice a una versión reciente de Nextcloud (vea #Configuración de Nextcloud) para resolver esto. Como una medida adicional, Usted puede descargar la "Brute-force settings" app for Nextcloud. Después de la instalación, añada la IP de su servidor Moodle a la lista blanca (whitelist).
Cuando intento crear un enlace de acceso controlado me sale un error de que no puedo descargar este archivo "Cannot download this file".
Estopuede pasar si la cuenta del sistema no está conectada. Vaya a Administración del sitio > Servidor > Servicios OAuth 2 e intente conectar nuevamente la cuenta del sistema de Nextcloud.