cas documentation

[Nader Karimi]

why cas 4 comes with a brief documentation? cas 3 has a great cas wiki that is much more comprehensive than 4s and it includes some examples.

as a newbie I am always confused by reading this docs and I have to go back to cas 3 wiki, and figure out the differences ...

[Dmitriy Kopylenko]

What exactly do you find confusing in the docs? Suggest an area of improvement, so the dev team could do the better job to fill the gaps. 

Best,

Dmitriy.

On Sun, May 8, 2016 at 15:19, Nader Karimi <nader.k...@gmail.com> wrote:

why cas 4 comes with a brief documentation? cas 3 has a great cas wiki that is much more comprehensive than 4s and it includes some examples.

as a newbie I am always confused by reading this docs and I have to go back to cas 3 wiki, and figure out the differences ...

--
You received this message because you are subscribed to the Google Groups "CAS Community" group.
To unsubscribe from this group and stop receiving emails from it, send an email to cas-user+u...@apereo.org.
To post to this group, send email to cas-...@apereo.org.
Visit this group at https://groups.google.com/a/apereo.org/group/cas-user/.
To view this discussion on the web visit https://groups.google.com/a/apereo.org/d/msgid/cas-user/67291aae-e389-4d10-b4bb-91ed8e9a3a7e%40apereo.org.
For more options, visit https://groups.google.com/a/apereo.org/d/optout.

[HACHED, MEHDI]

Hi,

I agree with Nader. I had a hard time just finding a documentation that explains how to have a CAS v4 server up and running. I eventually found this one for the v3:
https://wiki.jasig.org/display/CASUM/Best+Practice+-+Setting+Up+CAS+Locally+using+the+Maven+WAR+Overlay+Method

In general the documentation of the version 4 is lacking clarity (which files to edit, which sections...) and completion.
I think that everything is already existing but just scattered on github, Jasig and Apereo websites.

And by the way, all documentations and source code seems to have disappeared from JASIG Github. Is it intended?
http://jasig.github.io/cas/ (error 404)

Cheers,
Mehdi

To view this discussion on the web visit https://groups.google.com/a/apereo.org/d/msgid/cas-user/1462735495144-3536a6ca-3a554b7a-cde4cf06%40unicon.net.

[Dmitriy Kopylenko]

Please do note that project (source code and all assets) has moved to Apereo organization over the weekend. The docs now live here: http://apereo.github.io/cas/4.2.x/index.html

As far as maven overlay installation, the page is clearly linked from the front page of the docs and is available here: http://apereo.github.io/cas/4.2.x/installation/Maven-Overlay-Installation.html

I could agree that the current user interface of the docs does not provide for the best user experience and is something that the dev team will look into and will find better ways to re-design. 

As far as comments such as "documentation is lacking clarity" without any concrete examples will not do any good as it's hard to "improve" something based on just general, abstract statements. 

Cheers,

D.

To view this discussion on the web visit https://groups.google.com/a/apereo.org/d/msgid/cas-user/573046DB.2090604%40gmail.com.

[Josep Manel Andrés]

Hi,
Thanks for the link.

About the documentation, it is something that I have already asked. It
is like very hard to find examples, for instance, in the old version we
could find Tutorials and HOWTOs, and now we don't. Now the documentation
is very simplified and schematic, before it had like better explanations
to understand the whole system.

Regards!

> <mailto:cas-user+u...@apereo.org>cas-user+u...@apereo.org.

> To post to this group, send email to

> <mailto:cas-...@apereo.org>cas-...@apereo.org.

> Visit this group at
> https://groups.google.com/a/apereo.org/group/cas-user/.
> To view this discussion on the web visit

> <https://groups.google.com/a/apereo.org/d/msgid/cas-user/67291aae-e389-4d10-b4bb-91ed8e9a3a7e%40apereo.org?utm_medium=email&utm_source=footer>https://groups.google.com/a/apereo.org/d/msgid/cas-user/67291aae-e389-4d10-b4bb-91ed8e9a3a7e%40apereo.org.

> For more options, visit
> https://groups.google.com/a/apereo.org/d/optout.
>
> --
> You received this message because you are subscribed to the
> Google Groups "CAS Community" group.
> To unsubscribe from this group and stop receiving emails from
> it, send an email to cas-user+u...@apereo.org

> <mailto:cas-user+u...@apereo.org>.

> To post to this group, send email to cas-...@apereo.org

> <mailto:cas-...@apereo.org>.

> Visit this group at
> https://groups.google.com/a/apereo.org/group/cas-user/.
> To view this discussion on the web visit

> <https://groups.google.com/a/apereo.org/d/msgid/cas-user/1462735495144-3536a6ca-3a554b7a-cde4cf06%40unicon.net?utm_medium=email&utm_source=footer>https://groups.google.com/a/apereo.org/d/msgid/cas-user/1462735495144-3536a6ca-3a554b7a-cde4cf06%40unicon.net.

> For more options, visit
> https://groups.google.com/a/apereo.org/d/optout.
>
>
> --
> You received this message because you are subscribed to the Google
> Groups "CAS Community" group.
> To unsubscribe from this group and stop receiving emails from it,
> send an email to cas-user+u...@apereo.org

> <mailto:cas-user+u...@apereo.org>.

> To post to this group, send email to cas-...@apereo.org

> <mailto:cas-...@apereo.org>.

> Visit this group at
> https://groups.google.com/a/apereo.org/group/cas-user/.
> To view this discussion on the web visit

> https://groups.google.com/a/apereo.org/d/msgid/cas-user/573046DB.2090604%40gmail.com
> <https://groups.google.com/a/apereo.org/d/msgid/cas-user/573046DB.2090604%40gmail.com?utm_medium=email&utm_source=footer>.

> For more options, visit https://groups.google.com/a/apereo.org/d/optout.
>
> --
> You received this message because you are subscribed to the Google
> Groups "CAS Community" group.
> To unsubscribe from this group and stop receiving emails from it, send
> an email to cas-user+u...@apereo.org

> <mailto:cas-user+u...@apereo.org>.

> To post to this group, send email to cas-...@apereo.org

> <mailto:cas-...@apereo.org>.

> Visit this group at https://groups.google.com/a/apereo.org/group/cas-user/.
> To view this discussion on the web visit

> https://groups.google.com/a/apereo.org/d/msgid/cas-user/1462787383454-4b5343d9-10aa943e-fca9d3b4%40unicon.net
> <https://groups.google.com/a/apereo.org/d/msgid/cas-user/1462787383454-4b5343d9-10aa943e-fca9d3b4%40unicon.net?utm_medium=email&utm_source=footer>.

> For more options, visit https://groups.google.com/a/apereo.org/d/optout.

--

Josep Manel Andrés (josep....@bsc.es)
Operations - Barcelona Supercomputing Center
C/ Jordi Girona, 31 http://www.bsc.es
08034 Barcelona, Spain Tel: +34-93-405 42 14
e-mail: sys...@bsc.es Fax: +34-93-413 77 21
-----------------------------------------------

WARNING / LEGAL TEXT: This message is intended only for the use of the
individual or entity to which it is addressed and may contain
information which is privileged, confidential, proprietary, or exempt
from disclosure under applicable law. If you are not the intended
recipient or the person responsible for delivering the message to the
intended recipient, you are strictly prohibited from disclosing,
distributing, copying, or in any way using this message. If you have
received this communication in error, please notify the sender and
destroy and delete any copies you may have received.

http://www.bsc.es/disclaimer

[Dmitriy Kopylenko]

It's rightly noted that the current docs are just that - the official docs with predetermined format and the right amount of information for features of the CAS server. It is developed and maintained by CAS server developers implementing the software. On the other hand, the old confluence is a free-form wiki which is user contributed, hence you were able to get all this "rich" tutorial style content. May be it would be appropriate to consider ressurecting user-contributed wiki in some shape and form for just this very purpose. 

I'm finishing on this topic now and let other devs chime in here if they choose to do so. 

Cheers,

D.

To unsubscribe from this group and stop receiving emails from it, send an email to cas-user+u...@apereo.org.
To post to this group, send email to cas-...@apereo.org.

Visit this group at https://groups.google.com/a/apereo.org/group/cas-user/.

To view this discussion on the web visit https://groups.google.com/a/apereo.org/d/msgid/cas-user/57305FE4.4090607%40bsc.es.

[HACHED, MEHDI]

You're right Dimitri about providing concrete example. This one for instance, how to set up a CAS server (latest version)?:

1. Approach: A step by step guide (very useful):
1. https://wiki.jasig.org/display/CASUM/Best+Practice+-+Setting+Up+CAS+Locally+using+the+Maven+WAR+Overlay+Method
2. Approach: An overview of the installation and customisation principles that lacks clarity for someone that doesn't see how to do it eventually:
   
1. http://apereo.github.io/cas/4.2.x/installation/Maven-Overlay-Installation.html

Of course I'm not saying that it is possible to do a step by step guide for all the possible environments, but at least it helps to comprehend the technology behind Maven Overlay, Java Spring...

Anyhow, I'm thankful to the CAS team for their effort ;-)

Cheers,

[Nader Karimi]

for example, here :http://apereo.github.io/cas/4.2.x/installation/LDAP-Authentication.html

it says: The above configuration attempts to authenticate credentials via an authenticator to be defined later, and constructs a final CAS authenticated subject based on the sAMAccountName

and I don't know what is sAMAccountName !

[Misagh Moayyed]

See https://msdn.microsoft.com/en-us/library/ms679635(v=vs.85).aspx

 

What is your LDAP directory? If you are not familiar with sAMAccountName, chances are for you this would be uid or cn. Or even nothing. That value is optional.

 

--

You received this message because you are subscribed to the Google Groups "CAS Community" group.
To unsubscribe from this group and stop receiving emails from it, send an email to cas-user+u...@apereo.org.
To post to this group, send email to cas-...@apereo.org.
Visit this group at https://groups.google.com/a/apereo.org/group/cas-user/.

To view this discussion on the web visit https://groups.google.com/a/apereo.org/d/msgid/cas-user/17fb3975-b778-4453-beb9-3e86b13f40e7%40apereo.org.