You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@syncope.apache.org by Dmitriy Brashevets <Dm...@united-security-providers.ch> on 2020/10/13 14:39:42 UTC

RE: Fwd: How to generate swagger documentation

Hi Apache Syncope guys.

What version of Apache Syncope are you running?
I’m trying to run the Apache Syncope 2.0.16 on Tomcat 9.0.39.
I’m able run the Apache Syncope Core and I also enabled Swagger extension like described here<https://syncope.apache.org/docs/2.1/reference-guide.html#customization-core>, but when I’m accessing swagger I’m having an error:

Uncaught SyntaxError: Invalid regular expression: /[A-Za-z\xAA\xB5\xBA\xC0-\xD6\xD8-\xF6\xF8-Ë�ˆ-Ë‘Ë -ˤˬˮͰ-ʹͶͷͺ-ͽͿΆΈ-ΊΌΎ-ΡΣ-ϵϷ-Ò�ÒŠ-Ô¯Ô±-Õ–Õ™Õ¡-Ö‡×�-תװ-×²Ø -يٮٯٱ-Û“Û•Û¥Û¦Û®Û¯Ûº-Û¼Û¿Ü�Ü’-ܯÝ�-ޥޱߊ-ßªß´ßµßºà €-à •à šà ¤à ¨à¡€-ࡘࢠ-ࢴऄ-हऽà¥�क़-ॡॱ-ঀঅ-ঌà¦�à¦�ও-নপ-রলশ-হঽৎড়à§�য়-ৡৰৱਅ-ਊà¨�à¨�ਓ-ਨਪ-ਰਲਲ਼ਵਸ਼ਸਹਖ਼-ੜਫ਼ੲ-ੴઅ-àª�àª�-ઑઓ-નપ-રલળવ-હઽà«�ૠૡૹଅ-ଌà¬�à¬�ଓ-ନପ-ରଲଳଵ-ହଽଡ଼à­�à­Ÿ-ୡୱஃஅ-ஊஎ-à®�à®’-கஙசஜஞடணதந-பம-ஹà¯�à°…-ఌఎ-à°�à°’-నప-హఽౘ-ౚౠౡಅ-ಌಎ-à²�ಒ-ನಪ-ಳವ-ಹಽೞೠೡೱೲഅ-ഌഎ-à´�à´’-ഺഽൎൟ-ൡൺ-ൿඅ-ඖක-නඳ-රලව-à·†à¸�-ะาำเ-ๆàº�ຂຄງຈຊàº�ດ-ທນ-ຟມ-ຣລວສຫອ-ະາຳຽເ-ໄໆໜ-ໟༀཀ-ཇཉ-ཬྈ-ྌက-ဪဿá��-á�•á�š-á��á�¡á�¥á�¦á�®-á�°á�µ-á‚�á‚Žá‚ -ჅჇáƒ�áƒ�-ჺჼ-ቈቊ-á‰�á‰�-ቖቘቚ-á‰�በ-ኈኊ-áŠ�áŠ�-ኰኲ-ኵኸ-ኾዀዂ-ዅወ-ዖዘ-áŒ�ጒ-ጕጘ-á�šáŽ€-áŽ�Ꭰ-á�µá�¸-á�½á��-ᙬᙯ-ᙿáš�-áššáš -ᛪᛱ-ᛸᜀ-ᜌᜎ-ᜑᜠ-ᜱá�€-á�‘á� -á�¬á�®-á�°áž€-áž³áŸ—áŸœá  -ᡷᢀ-ᢨᢪᢰ-ᣵᤀ-ᤞá¥�-ᥭᥰ-ᥴᦀ-ᦫᦰ-ᧉᨀ-ᨖᨠ-ᩔᪧᬅ-ᬳᭅ-ᭋᮃ-ᮠᮮᮯᮺ-ᯥᰀ-á°£á±�-á±�ᱚ-ᱽᳩ-ᳬᳮ-ᳱᳵᳶᴀ-ᶿḀ-ἕἘ-á¼�á¼ -ὅὈ-á½�á½�-ὗὙὛá½�Ὗ-ώᾀ-ᾴᾶ-ᾼιῂ-ῄῆ-á¿Œá¿�-á¿“á¿–-Ίῠ-Ῥῲ-ῴῶ-ῼâ�±â�¿â‚�-ₜℂℇℊ-â„“â„•â„™-â„�ℤΩℨK-ℭℯ-ℹℼ-â„¿â……-ⅉⅎↃↄⰀ-Ⱞⰰ-ⱞⱠ-ⳤⳫ-ⳮⳲⳳⴀ-ⴥⴧⴭⴰ-ⵧⵯⶀ-ⶖⶠ-ⶦⶨ-ⶮⶰ-ⶶⶸ-ⶾⷀ-ⷆⷈ-â·Žâ·�-â·–â·˜-ⷞⸯ々〆〱-〵〻〼ã��-ã‚–ã‚�-ã‚Ÿã‚¡-ヺー-ヿㄅ-ㄭㄱ-ㆎㆠ-ㆺㇰ-ㇿã�€-䶵一-鿕ꀀ-ê’Œê“�-ꓽꔀ-ꘌê˜�-ꘟꘪꘫꙀ-ꙮꙿ-êš�êš -ꛥꜗ-ꜟꜢ-ꞈꞋ-êž­êž°-ꞷꟷ-ê �ê ƒ-ê …ê ‡-ê Šê Œ-ê ¢ê¡€-ꡳꢂ-ꢳꣲ-ꣷꣻꣽꤊ-ꤥꤰ-ê¥†ê¥ -ꥼꦄ-ꦲê§�ê§ -ꧤꧦ-ꧯꧺ-ꧾꨀ-ꨨꩀ-ê©‚ê©„-ê©‹ê© -ꩶꩺꩾ-ꪯꪱꪵꪶꪹ-ꪽꫀꫂꫛ-ê«�ê« -ꫪꫲ-ê«´ê¬�-ꬆꬉ-ꬎꬑ-ê¬–ê¬ -ꬦꬨ-ꬮꬰ-ê­šê­œ-ꭥꭰ-ꯢ가-힣ힰ-ퟆퟋ-ퟻ豈-ï©­ï©°-龎ff-stﬓ-ﬗï¬�ײַ-ﬨשׁ-זּטּ-לּמּנּï­�ףּפּצּ-ﮱﯓ-ï´½ïµ�-ï¶�ﶒ-ﷇﷰ-ﷻﹰ-ﹴﹶ-ﻼA-Zï½�-zヲ-하-ᅦᅧ-ï¿�ï¿’-ï¿—ï¿š-ï¿œ0-9Ù -Ù©Û°-۹߀-߉०-९০-৯੦-੯૦-૯୦-୯௦-௯౦-౯೦-೯൦-൯෦-à·¯à¹�-๙à»�-໙༠-༩á�€-á�‰á‚�-႙០-៩á �-á ™á¥†-á¥�á§�-᧙᪀-᪉áª�-᪙á­�-᭙᮰-᮹᱀-᱉á±�-á±™ê˜ -꘩ê£�-꣙꤀-꤉ê§�-꧙꧰-꧹ê©�-꩙꯰-꯹ï¼�-ï¼™.\-]*[A-Za-z\xAA\xB5\xBA\xC0-\xD6\xD8-\xF6\xF8-Ë�ˆ-Ë‘Ë -ˤˬˮͰ-ʹͶͷͺ-ͽͿΆΈ-ΊΌΎ-ΡΣ-ϵϷ-Ò�ÒŠ-Ô¯Ô±-Õ–Õ™Õ¡-Ö‡×�-תװ-×²Ø -يٮٯٱ-Û“Û•Û¥Û¦Û®Û¯Ûº-Û¼Û¿Ü�Ü’-ܯÝ�-ޥޱߊ-ßªß´ßµßºà €-à •à šà ¤à ¨à¡€-ࡘࢠ-ࢴऄ-हऽà¥�क़-ॡॱ-ঀঅ-ঌà¦�à¦�ও-নপ-রলশ-হঽৎড়à§�য়-ৡৰৱਅ-ਊà¨�à¨�ਓ-ਨਪ-ਰਲਲ਼ਵਸ਼ਸਹਖ਼-ੜਫ਼ੲ-ੴઅ-àª�àª�-ઑઓ-નપ-રલળવ-હઽà«�ૠૡૹଅ-ଌà¬�à¬�ଓ-ନପ-ରଲଳଵ-ହଽଡ଼à­�à­Ÿ-ୡୱஃஅ-ஊஎ-à®�à®’-கஙசஜஞடணதந-பம-ஹà¯�à°…-ఌఎ-à°�à°’-నప-హఽౘ-ౚౠౡಅ-ಌಎ-à²�ಒ-ನಪ-ಳವ-ಹಽೞೠೡೱೲഅ-ഌഎ-à´�à´’-ഺഽൎൟ-ൡൺ-ൿඅ-ඖක-නඳ-රලව-à·†à¸�-ะาำเ-ๆàº�ຂຄງຈຊàº�ດ-ທນ-ຟມ-ຣລວສຫອ-ະາຳຽເ-ໄໆໜ-ໟༀཀ-ཇཉ-ཬྈ-ྌက-ဪဿá��-á�•á�š-á��á�¡á�¥á�¦á�®-á�°á�µ-á‚�á‚Žá‚ -ჅჇáƒ�áƒ�-ჺჼ-ቈቊ-á‰�á‰�-ቖቘቚ-á‰�በ-ኈኊ-áŠ�áŠ�-ኰኲ-ኵኸ-ኾዀዂ-ዅወ-ዖዘ-áŒ�ጒ-ጕጘ-á�šáŽ€-áŽ�Ꭰ-á�µá�¸-á�½á��-ᙬᙯ-ᙿáš�-áššáš -ᛪᛱ-ᛸᜀ-ᜌᜎ-ᜑᜠ-ᜱá�€-á�‘á� -á�¬á�®-á�°áž€-áž³áŸ—áŸœá  -ᡷᢀ-ᢨᢪᢰ-ᣵᤀ-ᤞá¥�-ᥭᥰ-ᥴᦀ-ᦫᦰ-ᧉᨀ-ᨖᨠ-ᩔᪧᬅ-ᬳᭅ-ᭋᮃ-ᮠᮮᮯᮺ-ᯥᰀ-á°£á±�-á±�ᱚ-ᱽᳩ-ᳬᳮ-ᳱᳵᳶᴀ-ᶿḀ-ἕἘ-á¼�á¼ -ὅὈ-á½�á½�-ὗὙὛá½�Ὗ-ώᾀ-ᾴᾶ-ᾼιῂ-ῄῆ-á¿Œá¿�-á¿“á¿–-Ίῠ-Ῥῲ-ῴῶ-ῼâ�±â�¿â‚�-ₜℂℇℊ-â„“â„•â„™-â„�ℤΩℨK-ℭℯ-ℹℼ-â„¿â……-ⅉⅎↃↄⰀ-Ⱞⰰ-ⱞⱠ-ⳤⳫ-ⳮⳲⳳⴀ-ⴥⴧⴭⴰ-ⵧⵯⶀ-ⶖⶠ-ⶦⶨ-ⶮⶰ-ⶶⶸ-ⶾⷀ-ⷆⷈ-â·Žâ·�-â·–â·˜-ⷞⸯ々〆〱-〵〻〼ã��-ã‚–ã‚�-ã‚Ÿã‚¡-ヺー-ヿㄅ-ㄭㄱ-ㆎㆠ-ㆺㇰ-ㇿã�€-䶵一-鿕ꀀ-ê’Œê“�-ꓽꔀ-ꘌê˜�-ꘟꘪꘫꙀ-ꙮꙿ-êš�êš -ꛥꜗ-ꜟꜢ-ꞈꞋ-êž­êž°-ꞷꟷ-ê �ê ƒ-ê …ê ‡-ê Šê Œ-ê ¢ê¡€-ꡳꢂ-ꢳꣲ-ꣷꣻꣽꤊ-ꤥꤰ-ê¥†ê¥ -ꥼꦄ-ꦲê§�ê§ -ꧤꧦ-ꧯꧺ-ꧾꨀ-ꨨꩀ-ê©‚ê©„-ê©‹ê© -ꩶꩺꩾ-ꪯꪱꪵꪶꪹ-ꪽꫀꫂꫛ-ê«�ê« -ꫪꫲ-ê«´ê¬�-ꬆꬉ-ꬎꬑ-ê¬–ê¬ -ꬦꬨ-ꬮꬰ-ê­šê­œ-ꭥꭰ-ꯢ가-힣ힰ-ퟆퟋ-ퟻ豈-ï©­ï©°-龎ff-stﬓ-ﬗï¬�ײַ-ﬨשׁ-זּטּ-לּמּנּï­�ףּפּצּ-ﮱﯓ-ï´½ïµ�-ï¶�ﶒ-ﷇﷰ-ﷻﹰ-ﹴﹶ-ﻼA-Zï½�-zヲ-하-ᅦᅧ-ï¿�ï¿’-ï¿—ï¿š-ï¿œ0-9Ù -Ù©Û°-۹߀-߉०-९০-৯੦-੯૦-૯୦-୯௦-௯౦-౯೦-೯൦-൯෦-à·¯à¹�-๙à»�-໙༠-༩á�€-á�‰á‚�-႙០-៩á �-á ™á¥†-á¥�á§�-᧙᪀-᪉áª�-᪙á­�-᭙᮰-᮹᱀-᱉á±�-á±™ê˜ -꘩ê£�-꣙꤀-꤉ê§�-꧙꧰-꧹ê©�-꩙꯰-꯹ï¼�-ï¼™\-]/: Range out of order in character class
    at new RegExp (<anonymous>)
    at Object.r (Autolinker.js:1384)
    at Object.<anonymous> (swagger-ui-bundle.js:133)
    at n (bootstrap:19)
    at Object.<anonymous> (linkify.js:11)
    at n (bootstrap:19)
    at Object.<anonymous> (parser_core.js:22)
    at n (bootstrap:19)
    at Object.<anonymous> (index.js:9)
    at n (bootstrap:19)
(index):1 Unchecked runtime.lastError: Could not establish connection. Receiving end does not exist.
(index):61 Uncaught ReferenceError: SwaggerUIBundle is not defined
    at window.onload ((index):61)


Mapping for Swagger is working for me[protocol]://[host]:[port]/syncope/swagger/
But Swagger’s functionality doesn’t work.
I’m still trying to figure out where is an issue.

Any ideas why this happens? Haven’t you faced with such an error?

Kind Regards,
Dmitriy Brashevets

From: Andrea Patricelli <an...@apache.org>
Sent: Thursday, June 25, 2020 12:33 PM
To: user@syncope.apache.org
Subject: Re: Fwd: How to generate swagger documentation


Sorry, my bad.
The correct swagger url is

[protocol]://[host]:[port]/syncope/swagger/

Best regards,
Andrea
Il 25/06/20 11:30, Andrea Patricelli ha scritto:

Hi Anmol
Il 24/06/20 18:22, Anmol Sharma ha scritto:
Hi,

I'm a new user exploring the Maven project workflow for Apache Syncope. I tried to use the `syncope-ext-swagger-ui` to generate the swagger documentation.

When I run mvn clean package in the core module, I do not see swagger-ui docs or config generated. I also ran the build with the `all` profile but it did not notice any difference.

I'm wondering if you could point me to some documentation on how to enable / generate swagger docs for a standalone deployment of the core module?
Her you can find some docs about building Syncope in general [1]. To enable the swagger extension please follow [2], "Enable the Swagger extension" section. You can find swagger docs available at [protocol]://[host]:[port]/syncope-swagger/


Thanks
anmol

HTH,
Andrea

[1] https://syncope.apache.org/building

[2] https://syncope.apache.org/docs/2.1/reference-guide.html#customization-core



--
- Anmol

--

Dott. Andrea Patricelli

Tel. +39 3204524292



Engineer @ Tirasa S.r.l.

Viale Vittoria Colonna 97 - 65127 Pescara

Tel +39 0859116307 / FAX +39 0859111173

http://www.tirasa.net



Apache Syncope PMC Member

--

Dott. Andrea Patricelli

Tel. +39 3204524292



Engineer @ Tirasa S.r.l.

Viale Vittoria Colonna 97 - 65127 Pescara

Tel +39 0859116307 / FAX +39 0859111173

http://www.tirasa.net



Apache Syncope PMC Member

Re: Fwd: How to generate swagger documentation

Posted by Francesco Chicchiriccò <il...@apache.org>.
On 14/10/20 11:06, Dmitriy Brashevets wrote:
>
> Hi Franchesco.
>
>  
>
> My fault.
>
> I’m running Apache Syncope *2.1.6* instead of *2.0.16.*
>
> Sorry again for this typo.
>
No problems :-)

About 2.1.6 (and 2.1.7 of course) we have several running projects, all with Swagger UI enabled, all working fine.

I'd suggest anyway to proceed as indicated below to check your generated openapi.json.

Regards.

> *From:* Francesco Chicchiriccò <il...@apache.org>
> *Sent:* Wednesday, October 14, 2020 10:27 AM
> *To:* user@syncope.apache.org
> *Subject:* Re: Fwd: How to generate swagger documentation
>
>  
>
> Hi Dmitriy,
> I have just generated a new Syncope 2.0.16 project following
>
> http://syncope.apache.org/docs/2.0/getting-started.html#create-project
>
>  
>
> then built via
>
>  
>
> mvn -Pall clean install
>
>  
>
> and finally run via
>
>  
>
> cd enduser
> mvn -Pall,embedded
>
>  
>
> Swagger UI worked fine after accessing
>
> http://localhost:9080/syncope/swagger/
>
>  
>
> and making some sample queries.
>
>  
>
> Coming to your issue, I would suggest first to check that you have been actually following
>
>  
>
> https://syncope.apache.org/docs/2.0/reference-guide.html#customization-core
>
> and not
>
> https://syncope.apache.org/docs/2.1/reference-guide.html#customization-core
>
>  
>
> as you are writing below.
>
>  
>
> Secondly, try to access
>
> [protocol]://[host]:[port]/syncope/rest/openapi.json
>
>  
>
> and see what result you get; naturally, watch the Core logs as well.
>
>  
>
> HTH
> Regards.
>
>  
>
> On 13/10/20 16:39, Dmitriy Brashevets wrote:
>
>     Hi Apache Syncope guys.
>
>     What version of Apache Syncope are you running?
>     I’m trying to run the *Apache Syncope 2.0.16* on *Tomcat 9.0.39*.
>
>     I’m able run the Apache Syncope Core and I also enabled Swagger extension like described here <https://syncope.apache.org/docs/2.1/reference-guide.html#customization-core>, but when I’m accessing swagger I’m having an error:
>
>      
>
>     Uncaught SyntaxError: Invalid regular expression:
>     /[A-Za-z\xAA\xB5\xBA\xC0-\xD6\xD8-\xF6\xF8-�ˆ-ˑˠ-ˤˬˮͰ-ʹͶͷͺ-ͽͿΆΈ-ΊΌΎ-ΡΣ-ϵϷ-�Ҋ-ԯԱ-Ֆՙա-և�-תװ-ײؠ-يٮٯٱ-ۓەۥۦۮۯۺ-ۼۿ�ܒ-ܯ�-ޥޱߊ-ߪߴߵߺࠀ-ࠕࠚࠤࠨࡀ-ࡘࢠ-ࢴऄ-हऽ�क़-ॡॱ-ঀঅ-ঌ��ও-নপ-রলশ-হঽৎড়�য়-ৡৰৱਅ-ਊ��ਓ-ਨਪ-ਰਲਲ਼ਵਸ਼ਸਹਖ਼-ੜਫ਼ੲ-ੴઅ-��-ઑઓ-નપ-રલળવ-હઽ�ૠૡૹଅ-ଌ��ଓ-ନପ-ରଲଳଵ-ହଽଡ଼�ୟ-ୡୱஃஅ-ஊஎ-�ஒ-கஙசஜஞடணதந-பம-ஹ�అ-ఌఎ-�ఒ-నప-హఽౘ-ౚౠౡಅ-ಌಎ-�ಒ-ನಪ-ಳವ-ಹಽೞೠೡೱೲഅ-ഌഎ-�ഒ-ഺഽൎൟ-ൡൺ-ൿඅ-ඖක-නඳ-රලව-ෆ�-ะาำเ-ๆ�ຂຄງຈຊ�ດ-ທນ-ຟມ-ຣລວສຫອ-ະາຳຽເ-ໄໆໜ-ໟༀཀ-ཇཉ-ཬྈ-ྌက-ဪဿ�-��-�����-��-�ႎႠ-ჅჇ��-ჺჼ-ቈቊ-��-ቖቘቚ-�በ-ኈኊ-��-ኰኲ-ኵኸ-ኾዀዂ-ዅወ-ዖዘ-�ጒ-ጕጘ-�ᎀ-�Ꭰ-��-��-ᙬᙯ-ᙿ�-ᚚᚠ-ᛪᛱ-ᛸᜀ-ᜌᜎ-ᜑᜠ-ᜱ�-��-��-�ក-ឳៗៜᠠ-ᡷᢀ-ᢨᢪᢰ-ᣵᤀ-ᤞ�-ᥭᥰ-ᥴᦀ-ᦫᦰ-ᧉᨀ-ᨖᨠ-ᩔᪧᬅ-ᬳᭅ-ᭋᮃ-ᮠᮮᮯᮺ-ᯥᰀ-ᰣ�-�ᱚ-ᱽᳩ-ᳬᳮ-ᳱᳵᳶᴀ-ᶿḀ-ἕἘ-�ἠ-ὅὈ-��-ὗὙὛ�Ὗ-ώᾀ-ᾴᾶ-ᾼιῂ-ῄῆ-ῌ�-ΐῖ-Ίῠ-Ῥῲ-ῴῶ-ῼ���-ₜℂℇℊ-ℓℕℙ-�ℤΩℨK-ℭℯ-ℹℼ-ℿⅅ-ⅉⅎↃↄⰀ-Ⱞⰰ-ⱞⱠ-ⳤⳫ-ⳮⳲⳳⴀ-ⴥⴧⴭⴰ-ⵧⵯⶀ-ⶖⶠ-ⶦⶨ-ⶮⶰ-ⶶⶸ-ⶾⷀ-ⷆⷈ-ⷎ�-ⷖⷘ-ⷞⸯ々〆〱-〵〻〼�-ゖ�-ゟァ-ヺー-ヿㄅ-ㄭㄱ-ㆎㆠ-ㆺㇰ-ㇿ�-䶵一-鿕ꀀ-ꒌ�-ꓽꔀ-ꘌ�-ꘟꘪꘫꙀ-ꙮꙿ-�ꚠ-ꛥꜗ-ꜟꜢ-ꞈꞋ-ꞭꞰ-ꞷꟷ-�ꠃ-ꠅꠇ-ꠊꠌ-ꠢꡀ-ꡳꢂ-ꢳꣲ-ꣷꣻꣽꤊ-ꤥꤰ-ꥆꥠ-ꥼꦄ-ꦲ�ꧠ-ꧤꧦ-ꧯꧺ-ꧾꨀ-ꨨꩀ-ꩂꩄ-ꩋꩠ-ꩶꩺꩾ-ꪯꪱꪵꪶꪹ-ꪽꫀꫂꫛ-�ꫠ-ꫪꫲ-ꫴ�-ꬆꬉ-ꬎꬑ-ꬖꬠ-ꬦꬨ-ꬮꬰ-ꭚꭜ-ꭥꭰ-ꯢ가-힣ힰ-ퟆퟋ-ퟻ豈-舘並-龎ff-stﬓ-ﬗ�ײַ-ﬨשׁ-זּטּ-לּמּנּ�ףּפּצּ-ﮱﯓ-ﴽ�-�ﶒ-ﷇﷰ-ﷻﹰ-ﹴﹶ-ﻼA-Z�-zヲ-하-ᅦᅧ-�ᅭ-ᅲᅳ-ᅵ0-9٠-٩۰-۹߀-߉०-९০-৯੦-੯૦-૯୦-୯௦-௯౦-౯೦-೯൦-൯෦-෯�-๙�-໙༠-༩�-��-႙០-៩�-᠙᥆-��-᧙᪀-᪉�-᪙�-᭙᮰-᮹᱀-᱉�-᱙꘠-꘩�-꣙꤀-꤉�-꧙꧰-꧹�-꩙꯰-꯹�-9.\-]*[A-Za-z\xAA\xB5\xBA\xC0-\xD6\xD8-\xF6\xF8-�ˆ-ˑˠ-ˤˬˮͰ-ʹͶͷͺ-ͽͿΆΈ-ΊΌΎ-ΡΣ-ϵϷ-�Ҋ-ԯԱ-Ֆՙա-և�-תװ-ײؠ-يٮٯٱ-ۓەۥۦۮۯۺ-ۼۿ�ܒ-ܯ�-ޥޱߊ-ߪߴߵߺࠀ-ࠕࠚࠤࠨࡀ-ࡘࢠ-ࢴऄ-हऽ�क़-ॡॱ-ঀঅ-ঌ��ও-নপ-রলশ-হঽৎড়�য়-ৡৰৱਅ-ਊ��ਓ-ਨਪ-ਰਲਲ਼ਵਸ਼ਸਹਖ਼-ੜਫ਼ੲ-ੴઅ-��-ઑઓ-નપ-રલળવ-હઽ�ૠૡૹଅ-ଌ��ଓ-ନପ-ରଲଳଵ-ହଽଡ଼�ୟ-ୡୱஃஅ-ஊஎ-�ஒ-கஙசஜஞடணதந-பம-ஹ�అ-ఌఎ-�ఒ-నప-హఽౘ-ౚౠౡಅ-ಌಎ-�ಒ-ನಪ-ಳವ-ಹಽೞೠೡೱೲഅ-ഌഎ-�ഒ-ഺഽൎൟ-ൡൺ-ൿඅ-ඖක-නඳ-රලව-ෆ�-ะาำเ-ๆ�ຂຄງຈຊ�ດ-ທນ-ຟມ-ຣລວສຫອ-ະາຳຽເ-ໄໆໜ-ໟༀཀ-ཇཉ-ཬྈ-ྌက-ဪဿ�-��-�����-��-�ႎႠ-ჅჇ��-ჺჼ-ቈቊ-��-ቖቘቚ-�በ-ኈኊ-��-ኰኲ-ኵኸ-ኾዀዂ-ዅወ-ዖዘ-�ጒ-ጕጘ-�ᎀ-�Ꭰ-��-��-ᙬᙯ-ᙿ�-ᚚᚠ-ᛪᛱ-ᛸᜀ-ᜌᜎ-ᜑᜠ-ᜱ�-��-��-�ក-ឳៗៜᠠ-ᡷᢀ-ᢨᢪᢰ-ᣵᤀ-ᤞ�-ᥭᥰ-ᥴᦀ-ᦫᦰ-ᧉᨀ-ᨖᨠ-ᩔᪧᬅ-ᬳᭅ-ᭋᮃ-ᮠᮮᮯᮺ-ᯥᰀ-ᰣ�-�ᱚ-ᱽᳩ-ᳬᳮ-ᳱᳵᳶᴀ-ᶿḀ-ἕἘ-�ἠ-ὅὈ-��-ὗὙὛ�Ὗ-ώᾀ-ᾴᾶ-ᾼιῂ-ῄῆ-ῌ�-ΐῖ-Ίῠ-Ῥῲ-ῴῶ-ῼ���-ₜℂℇℊ-ℓℕℙ-�ℤΩℨK-ℭℯ-ℹℼ-ℿⅅ-ⅉⅎↃↄⰀ-Ⱞⰰ-ⱞⱠ-ⳤⳫ-ⳮⳲⳳⴀ-ⴥⴧⴭⴰ-ⵧⵯⶀ-ⶖⶠ-ⶦⶨ-ⶮⶰ-ⶶⶸ-ⶾⷀ-ⷆⷈ-ⷎ�-ⷖⷘ-ⷞⸯ々〆〱-〵〻〼�-ゖ�-ゟァ-ヺー-ヿㄅ-ㄭㄱ-ㆎㆠ-ㆺㇰ-ㇿ�-䶵一-鿕ꀀ-ꒌ�-ꓽꔀ-ꘌ�-ꘟꘪꘫꙀ-ꙮꙿ-�ꚠ-ꛥꜗ-ꜟꜢ-ꞈꞋ-ꞭꞰ-ꞷꟷ-�ꠃ-ꠅꠇ-ꠊꠌ-ꠢꡀ-ꡳꢂ-ꢳꣲ-ꣷꣻꣽꤊ-ꤥꤰ-ꥆꥠ-ꥼꦄ-ꦲ�ꧠ-ꧤꧦ-ꧯꧺ-ꧾꨀ-ꨨꩀ-ꩂꩄ-ꩋꩠ-ꩶꩺꩾ-ꪯꪱꪵꪶꪹ-ꪽꫀꫂꫛ-�ꫠ-ꫪꫲ-ꫴ�-ꬆꬉ-ꬎꬑ-ꬖꬠ-ꬦꬨ-ꬮꬰ-ꭚꭜ-ꭥꭰ-ꯢ가-힣ힰ-ퟆퟋ-ퟻ豈-舘並-龎ff-stﬓ-ﬗ�ײַ-ﬨשׁ-זּטּ-לּמּנּ�ףּפּצּ-ﮱﯓ-ﴽ�-�ﶒ-ﷇﷰ-ﷻﹰ-ﹴﹶ-ﻼA-Z�-zヲ-하-ᅦᅧ-�ᅭ-ᅲᅳ-ᅵ0-9٠-٩۰-۹߀-߉०-९০-৯੦-੯૦-૯୦-୯௦-௯౦-౯೦-೯൦-൯෦-෯�-๙�-໙༠-༩�-��-႙០-៩�-᠙᥆-��-᧙᪀-᪉�-᪙�-᭙᮰-᮹᱀-᱉�-᱙꘠-꘩�-꣙꤀-꤉�-꧙꧰-꧹�-꩙꯰-꯹�-9\-]/:
>     Range out of order in character class
>
>         at new RegExp (<anonymous>)
>
>         at Object.r (Autolinker.js:1384)
>
>         at Object.<anonymous> (swagger-ui-bundle.js:133)
>
>         at n (bootstrap:19)
>
>         at Object.<anonymous> (linkify.js:11)
>
>         at n (bootstrap:19)
>
>         at Object.<anonymous> (parser_core.js:22)
>
>         at n (bootstrap:19)
>
>         at Object.<anonymous> (index.js:9)
>
>         at n (bootstrap:19)
>
>     (index):1 Unchecked runtime.lastError: Could not establish connection. Receiving end does not exist.
>
>     (index):61 Uncaught ReferenceError: SwaggerUIBundle is not defined
>
>         at window.onload ((index):61)
>
>      
>
>     Mapping for Swagger is working for me[protocol]://[host]:[port]/syncope/swagger/
>
>     But Swagger’s functionality doesn’t work.
>     I’m still trying to figure out where is an issue.
>
>      
>
>     Any ideas why this happens? Haven’t you faced with such an error?
>
>     Kind Regards,
>     Dmitriy Brashevets
>
>      
>
>     *From:* Andrea Patricelli <an...@apache.org> <ma...@apache.org>
>     *Sent:* Thursday, June 25, 2020 12:33 PM
>     *To:* user@syncope.apache.org <ma...@syncope.apache.org>
>     *Subject:* Re: Fwd: How to generate swagger documentation
>
>      
>
>     Sorry, my bad.
>     The correct swagger url is
>
>     [protocol]://[host]:[port]/syncope/swagger/
>
>     Best regards,
>     Andrea
>
>     Il 25/06/20 11:30, Andrea Patricelli ha scritto:
>
>         Hi Anmol
>
>         Il 24/06/20 18:22, Anmol Sharma ha scritto:
>
>             Hi,
>
>              
>
>             I'm a new user exploring the Maven project workflow for Apache Syncope. I tried to use the `syncope-ext-swagger-ui` to generate the swagger documentation.
>
>              
>
>             When I run mvn clean package in the core module, I do not see swagger-ui docs or config generated. I also ran the build with the `all` profile but it did not notice any difference.
>
>              
>
>             I'm wondering if you could point me to some documentation on how to enable / generate swagger docs for a standalone deployment of the core module?
>
>         Her you can find some docs about building Syncope in general [1]. To enable the swagger extension please follow [2], "Enable the Swagger extension" section. You can find swagger docs available at [protocol]://[host]:[port]/syncope-swagger/
>
>
>              
>
>             Thanks
>
>             anmol
>
>         HTH,
>         Andrea
>
>         [1] https://syncope.apache.org/building
>
>         [2] https://syncope.apache.org/docs/2.1/reference-guide.html#customization-core
>
-- 
Francesco Chicchiriccò

Tirasa - Open Source Excellence
http://www.tirasa.net/

Member at The Apache Software Foundation
Syncope, Cocoon, Olingo, CXF, OpenJPA, PonyMail
http://home.apache.org/~ilgrosso/


RE: Fwd: How to generate swagger documentation

Posted by Dmitriy Brashevets <Dm...@united-security-providers.ch>.
Hi Franchesco.

My fault.

I’m running Apache Syncope 2.1.6 instead of 2.0.16.
Sorry again for this typo.

Kind Regards,
Dmitriy Brashevets

From: Francesco Chicchiriccò <il...@apache.org>
Sent: Wednesday, October 14, 2020 10:27 AM
To: user@syncope.apache.org
Subject: Re: Fwd: How to generate swagger documentation

Hi Dmitriy,
I have just generated a new Syncope 2.0.16 project following

http://syncope.apache.org/docs/2.0/getting-started.html#create-project

then built via

mvn -Pall clean install

and finally run via

cd enduser
mvn -Pall,embedded

Swagger UI worked fine after accessing

http://localhost:9080/syncope/swagger/

and making some sample queries.

Coming to your issue, I would suggest first to check that you have been actually following

https://syncope.apache.org/docs/2.0/reference-guide.html#customization-core

and not

https://syncope.apache.org/docs/2.1/reference-guide.html#customization-core

as you are writing below.

Secondly, try to access

[protocol]://[host]:[port]/syncope/rest/openapi.json

and see what result you get; naturally, watch the Core logs as well.

HTH
Regards.

On 13/10/20 16:39, Dmitriy Brashevets wrote:
Hi Apache Syncope guys.

What version of Apache Syncope are you running?
I’m trying to run the Apache Syncope 2.0.16 on Tomcat 9.0.39.
I’m able run the Apache Syncope Core and I also enabled Swagger extension like described here<https://syncope.apache.org/docs/2.1/reference-guide.html#customization-core>, but when I’m accessing swagger I’m having an error:

Uncaught SyntaxError: Invalid regular expression: /[A-Za-z\xAA\xB5\xBA\xC0-\xD6\xD8-\xF6\xF8-Ë�ˆ-Ë‘Ë -ˤˬˮͰ-ʹͶͷͺ-ͽͿΆΈ-ΊΌΎ-ΡΣ-ϵϷ-Ò�ÒŠ-Ô¯Ô±-Õ–Õ™Õ¡-Ö‡×�-תװ-×²Ø -يٮٯٱ-Û“Û•Û¥Û¦Û®Û¯Ûº-Û¼Û¿Ü�Ü’-ܯÝ�-ޥޱߊ-ßªß´ßµßºà €-à •à šà ¤à ¨à¡€-ࡘࢠ-ࢴऄ-हऽà¥�क़-ॡॱ-ঀঅ-ঌà¦�à¦�ও-নপ-রলশ-হঽৎড়à§�য়-ৡৰৱਅ-ਊà¨�à¨�ਓ-ਨਪ-ਰਲਲ਼ਵਸ਼ਸਹਖ਼-ੜਫ਼ੲ-ੴઅ-àª�àª�-ઑઓ-નપ-રલળવ-હઽà«�ૠૡૹଅ-ଌà¬�à¬�ଓ-ନପ-ରଲଳଵ-ହଽଡ଼à­�à­Ÿ-ୡୱஃஅ-ஊஎ-à®�à®’-கஙசஜஞடணதந-பம-ஹà¯�à°…-ఌఎ-à°�à°’-నప-హఽౘ-ౚౠౡಅ-ಌಎ-à²�ಒ-ನಪ-ಳವ-ಹಽೞೠೡೱೲഅ-ഌഎ-à´�à´’-ഺഽൎൟ-ൡൺ-ൿඅ-ඖක-නඳ-රලව-à·†à¸�-ะาำเ-ๆàº�ຂຄງຈຊàº�ດ-ທນ-ຟມ-ຣລວສຫອ-ະາຳຽເ-ໄໆໜ-ໟༀཀ-ཇཉ-ཬྈ-ྌက-ဪဿá��-á�•á�š-á��á�¡á�¥á�¦á�®-á�°á�µ-á‚�á‚Žá‚ -ჅჇáƒ�áƒ�-ჺჼ-ቈቊ-á‰�á‰�-ቖቘቚ-á‰�በ-ኈኊ-áŠ�áŠ�-ኰኲ-ኵኸ-ኾዀዂ-ዅወ-ዖዘ-áŒ�ጒ-ጕጘ-á�šáŽ€-áŽ�Ꭰ-á�µá�¸-á�½á��-ᙬᙯ-ᙿáš�-áššáš -ᛪᛱ-ᛸᜀ-ᜌᜎ-ᜑᜠ-ᜱá�€-á�‘á� -á�¬á�®-á�°áž€-áž³áŸ—áŸœá  -ᡷᢀ-ᢨᢪᢰ-ᣵᤀ-ᤞá¥�-ᥭᥰ-ᥴᦀ-ᦫᦰ-ᧉᨀ-ᨖᨠ-ᩔᪧᬅ-ᬳᭅ-ᭋᮃ-ᮠᮮᮯᮺ-ᯥᰀ-á°£á±�-á±�ᱚ-ᱽᳩ-ᳬᳮ-ᳱᳵᳶᴀ-ᶿḀ-ἕἘ-á¼�á¼ -ὅὈ-á½�á½�-ὗὙὛá½�Ὗ-ώᾀ-ᾴᾶ-ᾼιῂ-ῄῆ-á¿Œá¿�-á¿“á¿–-Ίῠ-Ῥῲ-ῴῶ-ῼâ�±â�¿â‚�-ₜℂℇℊ-â„“â„•â„™-â„�ℤΩℨK-ℭℯ-ℹℼ-â„¿â……-ⅉⅎↃↄⰀ-Ⱞⰰ-ⱞⱠ-ⳤⳫ-ⳮⳲⳳⴀ-ⴥⴧⴭⴰ-ⵧⵯⶀ-ⶖⶠ-ⶦⶨ-ⶮⶰ-ⶶⶸ-ⶾⷀ-ⷆⷈ-â·Žâ·�-â·–â·˜-ⷞⸯ々〆〱-〵〻〼ã��-ã‚–ã‚�-ã‚Ÿã‚¡-ヺー-ヿㄅ-ㄭㄱ-ㆎㆠ-ㆺㇰ-ㇿã�€-䶵一-鿕ꀀ-ê’Œê“�-ꓽꔀ-ꘌê˜�-ꘟꘪꘫꙀ-ꙮꙿ-êš�êš -ꛥꜗ-ꜟꜢ-ꞈꞋ-êž­êž°-ꞷꟷ-ê �ê ƒ-ê …ê ‡-ê Šê Œ-ê ¢ê¡€-ꡳꢂ-ꢳꣲ-ꣷꣻꣽꤊ-ꤥꤰ-ê¥†ê¥ -ꥼꦄ-ꦲê§�ê§ -ꧤꧦ-ꧯꧺ-ꧾꨀ-ꨨꩀ-ê©‚ê©„-ê©‹ê© -ꩶꩺꩾ-ꪯꪱꪵꪶꪹ-ꪽꫀꫂꫛ-ê«�ê« -ꫪꫲ-ê«´ê¬�-ꬆꬉ-ꬎꬑ-ê¬–ê¬ -ꬦꬨ-ꬮꬰ-ê­šê­œ-ꭥꭰ-ꯢ가-힣ힰ-ퟆퟋ-ퟻ豈-ï©­ï©°-龎ff-stﬓ-ﬗï¬�ײַ-ﬨשׁ-זּטּ-לּמּנּï­�ףּפּצּ-ﮱﯓ-ï´½ïµ�-ï¶�ﶒ-ﷇﷰ-ﷻﹰ-ﹴﹶ-ﻼA-Zï½�-zヲ-하-ᅦᅧ-ï¿�ï¿’-ï¿—ï¿š-ï¿œ0-9Ù -Ù©Û°-۹߀-߉०-९০-৯੦-੯૦-૯୦-୯௦-௯౦-౯೦-೯൦-൯෦-à·¯à¹�-๙à»�-໙༠-༩á�€-á�‰á‚�-႙០-៩á �-á ™á¥†-á¥�á§�-᧙᪀-᪉áª�-᪙á­�-᭙᮰-᮹᱀-᱉á±�-á±™ê˜ -꘩ê£�-꣙꤀-꤉ê§�-꧙꧰-꧹ê©�-꩙꯰-꯹ï¼�-ï¼™.\-]*[A-Za-z\xAA\xB5\xBA\xC0-\xD6\xD8-\xF6\xF8-Ë�ˆ-Ë‘Ë -ˤˬˮͰ-ʹͶͷͺ-ͽͿΆΈ-ΊΌΎ-ΡΣ-ϵϷ-Ò�ÒŠ-Ô¯Ô±-Õ–Õ™Õ¡-Ö‡×�-תװ-×²Ø -يٮٯٱ-Û“Û•Û¥Û¦Û®Û¯Ûº-Û¼Û¿Ü�Ü’-ܯÝ�-ޥޱߊ-ßªß´ßµßºà €-à •à šà ¤à ¨à¡€-ࡘࢠ-ࢴऄ-हऽà¥�क़-ॡॱ-ঀঅ-ঌà¦�à¦�ও-নপ-রলশ-হঽৎড়à§�য়-ৡৰৱਅ-ਊà¨�à¨�ਓ-ਨਪ-ਰਲਲ਼ਵਸ਼ਸਹਖ਼-ੜਫ਼ੲ-ੴઅ-àª�àª�-ઑઓ-નપ-રલળવ-હઽà«�ૠૡૹଅ-ଌà¬�à¬�ଓ-ନପ-ରଲଳଵ-ହଽଡ଼à­�à­Ÿ-ୡୱஃஅ-ஊஎ-à®�à®’-கஙசஜஞடணதந-பம-ஹà¯�à°…-ఌఎ-à°�à°’-నప-హఽౘ-ౚౠౡಅ-ಌಎ-à²�ಒ-ನಪ-ಳವ-ಹಽೞೠೡೱೲഅ-ഌഎ-à´�à´’-ഺഽൎൟ-ൡൺ-ൿඅ-ඖක-නඳ-රලව-à·†à¸�-ะาำเ-ๆàº�ຂຄງຈຊàº�ດ-ທນ-ຟມ-ຣລວສຫອ-ະາຳຽເ-ໄໆໜ-ໟༀཀ-ཇཉ-ཬྈ-ྌက-ဪဿá��-á�•á�š-á��á�¡á�¥á�¦á�®-á�°á�µ-á‚�á‚Žá‚ -ჅჇáƒ�áƒ�-ჺჼ-ቈቊ-á‰�á‰�-ቖቘቚ-á‰�በ-ኈኊ-áŠ�áŠ�-ኰኲ-ኵኸ-ኾዀዂ-ዅወ-ዖዘ-áŒ�ጒ-ጕጘ-á�šáŽ€-áŽ�Ꭰ-á�µá�¸-á�½á��-ᙬᙯ-ᙿáš�-áššáš -ᛪᛱ-ᛸᜀ-ᜌᜎ-ᜑᜠ-ᜱá�€-á�‘á� -á�¬á�®-á�°áž€-áž³áŸ—áŸœá  -ᡷᢀ-ᢨᢪᢰ-ᣵᤀ-ᤞá¥�-ᥭᥰ-ᥴᦀ-ᦫᦰ-ᧉᨀ-ᨖᨠ-ᩔᪧᬅ-ᬳᭅ-ᭋᮃ-ᮠᮮᮯᮺ-ᯥᰀ-á°£á±�-á±�ᱚ-ᱽᳩ-ᳬᳮ-ᳱᳵᳶᴀ-ᶿḀ-ἕἘ-á¼�á¼ -ὅὈ-á½�á½�-ὗὙὛá½�Ὗ-ώᾀ-ᾴᾶ-ᾼιῂ-ῄῆ-á¿Œá¿�-á¿“á¿–-Ίῠ-Ῥῲ-ῴῶ-ῼâ�±â�¿â‚�-ₜℂℇℊ-â„“â„•â„™-â„�ℤΩℨK-ℭℯ-ℹℼ-â„¿â……-ⅉⅎↃↄⰀ-Ⱞⰰ-ⱞⱠ-ⳤⳫ-ⳮⳲⳳⴀ-ⴥⴧⴭⴰ-ⵧⵯⶀ-ⶖⶠ-ⶦⶨ-ⶮⶰ-ⶶⶸ-ⶾⷀ-ⷆⷈ-â·Žâ·�-â·–â·˜-ⷞⸯ々〆〱-〵〻〼ã��-ã‚–ã‚�-ã‚Ÿã‚¡-ヺー-ヿㄅ-ㄭㄱ-ㆎㆠ-ㆺㇰ-ㇿã�€-䶵一-鿕ꀀ-ê’Œê“�-ꓽꔀ-ꘌê˜�-ꘟꘪꘫꙀ-ꙮꙿ-êš�êš -ꛥꜗ-ꜟꜢ-ꞈꞋ-êž­êž°-ꞷꟷ-ê �ê ƒ-ê …ê ‡-ê Šê Œ-ê ¢ê¡€-ꡳꢂ-ꢳꣲ-ꣷꣻꣽꤊ-ꤥꤰ-ê¥†ê¥ -ꥼꦄ-ꦲê§�ê§ -ꧤꧦ-ꧯꧺ-ꧾꨀ-ꨨꩀ-ê©‚ê©„-ê©‹ê© -ꩶꩺꩾ-ꪯꪱꪵꪶꪹ-ꪽꫀꫂꫛ-ê«�ê« -ꫪꫲ-ê«´ê¬�-ꬆꬉ-ꬎꬑ-ê¬–ê¬ -ꬦꬨ-ꬮꬰ-ê­šê­œ-ꭥꭰ-ꯢ가-힣ힰ-ퟆퟋ-ퟻ豈-ï©­ï©°-龎ff-stﬓ-ﬗï¬�ײַ-ﬨשׁ-זּטּ-לּמּנּï­�ףּפּצּ-ﮱﯓ-ï´½ïµ�-ï¶�ﶒ-ﷇﷰ-ﷻﹰ-ﹴﹶ-ﻼA-Zï½�-zヲ-하-ᅦᅧ-ï¿�ï¿’-ï¿—ï¿š-ï¿œ0-9Ù -Ù©Û°-۹߀-߉०-९০-৯੦-੯૦-૯୦-୯௦-௯౦-౯೦-೯൦-൯෦-à·¯à¹�-๙à»�-໙༠-༩á�€-á�‰á‚�-႙០-៩á �-á ™á¥†-á¥�á§�-᧙᪀-᪉áª�-᪙á­�-᭙᮰-᮹᱀-᱉á±�-á±™ê˜ -꘩ê£�-꣙꤀-꤉ê§�-꧙꧰-꧹ê©�-꩙꯰-꯹ï¼�-ï¼™\-]/: Range out of order in character class
    at new RegExp (<anonymous>)
    at Object.r (Autolinker.js:1384)
    at Object.<anonymous> (swagger-ui-bundle.js:133)
    at n (bootstrap:19)
    at Object.<anonymous> (linkify.js:11)
    at n (bootstrap:19)
    at Object.<anonymous> (parser_core.js:22)
    at n (bootstrap:19)
    at Object.<anonymous> (index.js:9)
    at n (bootstrap:19)
(index):1 Unchecked runtime.lastError: Could not establish connection. Receiving end does not exist.
(index):61 Uncaught ReferenceError: SwaggerUIBundle is not defined
    at window.onload ((index):61)


Mapping for Swagger is working for me[protocol]://[host]:[port]/syncope/swagger/
But Swagger’s functionality doesn’t work.
I’m still trying to figure out where is an issue.

Any ideas why this happens? Haven’t you faced with such an error?

Kind Regards,
Dmitriy Brashevets

From: Andrea Patricelli <an...@apache.org>
Sent: Thursday, June 25, 2020 12:33 PM
To: user@syncope.apache.org<ma...@syncope.apache.org>
Subject: Re: Fwd: How to generate swagger documentation


Sorry, my bad.
The correct swagger url is

[protocol]://[host]:[port]/syncope/swagger/

Best regards,
Andrea
Il 25/06/20 11:30, Andrea Patricelli ha scritto:

Hi Anmol
Il 24/06/20 18:22, Anmol Sharma ha scritto:
Hi,

I'm a new user exploring the Maven project workflow for Apache Syncope. I tried to use the `syncope-ext-swagger-ui` to generate the swagger documentation.

When I run mvn clean package in the core module, I do not see swagger-ui docs or config generated. I also ran the build with the `all` profile but it did not notice any difference.

I'm wondering if you could point me to some documentation on how to enable / generate swagger docs for a standalone deployment of the core module?
Her you can find some docs about building Syncope in general [1]. To enable the swagger extension please follow [2], "Enable the Swagger extension" section. You can find swagger docs available at [protocol]://[host]:[port]/syncope-swagger/



Thanks
anmol

HTH,
Andrea

[1] https://syncope.apache.org/building

[2] https://syncope.apache.org/docs/2.1/reference-guide.html#customization-core



--
- Anmol

--

Dott. Andrea Patricelli

Tel. +39 3204524292



Engineer @ Tirasa S.r.l.

Viale Vittoria Colonna 97 - 65127 Pescara

Tel +39 0859116307 / FAX +39 0859111173

http://www.tirasa.net



Apache Syncope PMC Member

--

Dott. Andrea Patricelli

Tel. +39 3204524292



Engineer @ Tirasa S.r.l.

Viale Vittoria Colonna 97 - 65127 Pescara

Tel +39 0859116307 / FAX +39 0859111173

http://www.tirasa.net



Apache Syncope PMC Member



--

Francesco Chicchiriccò



Tirasa - Open Source Excellence

http://www.tirasa.net/



Member at The Apache Software Foundation

Syncope, Cocoon, Olingo, CXF, OpenJPA, PonyMail

http://home.apache.org/~ilgrosso/

Re: Fwd: How to generate swagger documentation

Posted by Francesco Chicchiriccò <il...@apache.org>.
Hi Dmitriy,
I have just generated a new Syncope 2.0.16 project following

http://syncope.apache.org/docs/2.0/getting-started.html#create-project

then built via

mvn -Pall clean install

and finally run via

cd enduser
mvn -Pall,embedded

Swagger UI worked fine after accessing

http://localhost:9080/syncope/swagger/

and making some sample queries.

Coming to your issue, I would suggest first to check that you have been actually following

https://syncope.apache.org/docs/2.0/reference-guide.html#customization-core

and not

https://syncope.apache.org/docs/2.1/reference-guide.html#customization-core

as you are writing below.

Secondly, try to access

[protocol]://[host]:[port]/syncope/rest/openapi.json

and see what result you get; naturally, watch the Core logs as well.

HTH
Regards.

On 13/10/20 16:39, Dmitriy Brashevets wrote:
>
> Hi Apache Syncope guys.
>
> What version of Apache Syncope are you running?
> I’m trying to run the *Apache Syncope 2.0.16* on *Tomcat 9.0.39*.
>
> I’m able run the Apache Syncope Core and I also enabled Swagger extension like described here <https://syncope.apache.org/docs/2.1/reference-guide.html#customization-core>, but when I’m accessing swagger I’m having an error:
>
>  
>
> Uncaught SyntaxError: Invalid regular expression:
> /[A-Za-z\xAA\xB5\xBA\xC0-\xD6\xD8-\xF6\xF8-�ˆ-ˑˠ-ˤˬˮͰ-ʹͶͷͺ-ͽͿΆΈ-ΊΌΎ-ΡΣ-ϵϷ-�Ҋ-ԯԱ-Ֆՙա-և�-תװ-ײؠ-يٮٯٱ-ۓەۥۦۮۯۺ-ۼۿ�ܒ-ܯ�-ޥޱߊ-ߪߴߵߺࠀ-ࠕࠚࠤࠨࡀ-ࡘࢠ-ࢴऄ-हऽ�क़-ॡॱ-ঀঅ-ঌ��ও-নপ-রলশ-হঽৎড়�য়-ৡৰৱਅ-ਊ��ਓ-ਨਪ-ਰਲਲ਼ਵਸ਼ਸਹਖ਼-ੜਫ਼ੲ-ੴઅ-��-ઑઓ-નપ-રલળવ-હઽ�ૠૡૹଅ-ଌ��ଓ-ନପ-ରଲଳଵ-ହଽଡ଼�ୟ-ୡୱஃஅ-ஊஎ-�ஒ-கஙசஜஞடணதந-பம-ஹ�అ-ఌఎ-�ఒ-నప-హఽౘ-ౚౠౡಅ-ಌಎ-�ಒ-ನಪ-ಳವ-ಹಽೞೠೡೱೲഅ-ഌഎ-�ഒ-ഺഽൎൟ-ൡൺ-ൿඅ-ඖක-නඳ-රලව-ෆ�-ะาำเ-ๆ�ຂຄງຈຊ�ດ-ທນ-ຟມ-ຣລວສຫອ-ະາຳຽເ-ໄໆໜ-ໟༀཀ-ཇཉ-ཬྈ-ྌက-ဪဿ�-��-�����-��-�ႎႠ-ჅჇ��-ჺჼ-ቈቊ-��-ቖቘቚ-�በ-ኈኊ-��-ኰኲ-ኵኸ-ኾዀዂ-ዅወ-ዖዘ-�ጒ-ጕጘ-�ᎀ-�Ꭰ-��-��-ᙬᙯ-ᙿ�-ᚚᚠ-ᛪᛱ-ᛸᜀ-ᜌᜎ-ᜑᜠ-ᜱ�-��-��-�ក-ឳៗៜᠠ-ᡷᢀ-ᢨᢪᢰ-ᣵᤀ-ᤞ�-ᥭᥰ-ᥴᦀ-ᦫᦰ-ᧉᨀ-ᨖᨠ-ᩔᪧᬅ-ᬳᭅ-ᭋᮃ-ᮠᮮᮯᮺ-ᯥᰀ-ᰣ�-�ᱚ-ᱽᳩ-ᳬᳮ-ᳱᳵᳶᴀ-ᶿḀ-ἕἘ-�ἠ-ὅὈ-��-ὗὙὛ�Ὗ-ώᾀ-ᾴᾶ-ᾼιῂ-ῄῆ-ῌ�-ΐῖ-Ίῠ-Ῥῲ-ῴῶ-ῼ���-ₜℂℇℊ-ℓℕℙ-�ℤΩℨK-ℭℯ-ℹℼ-ℿⅅ-ⅉⅎↃↄⰀ-Ⱞⰰ-ⱞⱠ-ⳤⳫ-ⳮⳲⳳⴀ-ⴥⴧⴭⴰ-ⵧⵯⶀ-ⶖⶠ-ⶦⶨ-ⶮⶰ-ⶶⶸ-ⶾⷀ-ⷆⷈ-ⷎ�-ⷖⷘ-ⷞⸯ々〆〱-〵〻〼�-ゖ�-ゟァ-ヺー-ヿㄅ-ㄭㄱ-ㆎㆠ-ㆺㇰ-ㇿ�-䶵一-鿕ꀀ-ꒌ�-ꓽꔀ-ꘌ�-ꘟꘪꘫꙀ-ꙮꙿ-�ꚠ-ꛥꜗ-ꜟꜢ-ꞈꞋ-ꞭꞰ-ꞷꟷ-�ꠃ-ꠅꠇ-ꠊꠌ-ꠢꡀ-ꡳꢂ-ꢳꣲ-ꣷꣻꣽꤊ-ꤥꤰ-ꥆꥠ-ꥼꦄ-ꦲ�ꧠ-ꧤꧦ-ꧯꧺ-ꧾꨀ-ꨨꩀ-ꩂꩄ-ꩋꩠ-ꩶꩺꩾ-ꪯꪱꪵꪶꪹ-ꪽꫀꫂꫛ-�ꫠ-ꫪꫲ-ꫴ�-ꬆꬉ-ꬎꬑ-ꬖꬠ-ꬦꬨ-ꬮꬰ-ꭚꭜ-ꭥꭰ-ꯢ가-힣ힰ-ퟆퟋ-ퟻ豈-舘並-龎ff-stﬓ-ﬗ�ײַ-ﬨשׁ-זּטּ-לּמּנּ�ףּפּצּ-ﮱﯓ-ﴽ�-�ﶒ-ﷇﷰ-ﷻﹰ-ﹴﹶ-ﻼA-Z�-zヲ-하-ᅦᅧ-�ᅭ-ᅲᅳ-ᅵ0-9٠-٩۰-۹߀-߉०-९০-৯੦-੯૦-૯୦-୯௦-௯౦-౯೦-೯൦-൯෦-෯�-๙�-໙༠-༩�-��-႙០-៩�-᠙᥆-��-᧙᪀-᪉�-᪙�-᭙᮰-᮹᱀-᱉�-᱙꘠-꘩�-꣙꤀-꤉�-꧙꧰-꧹�-꩙꯰-꯹�-9.\-]*[A-Za-z\xAA\xB5\xBA\xC0-\xD6\xD8-\xF6\xF8-�ˆ-ˑˠ-ˤˬˮͰ-ʹͶͷͺ-ͽͿΆΈ-ΊΌΎ-ΡΣ-ϵϷ-�Ҋ-ԯԱ-Ֆՙա-և�-תװ-ײؠ-يٮٯٱ-ۓەۥۦۮۯۺ-ۼۿ�ܒ-ܯ�-ޥޱߊ-ߪߴߵߺࠀ-ࠕࠚࠤࠨࡀ-ࡘࢠ-ࢴऄ-हऽ�क़-ॡॱ-ঀঅ-ঌ��ও-নপ-রলশ-হঽৎড়�য়-ৡৰৱਅ-ਊ��ਓ-ਨਪ-ਰਲਲ਼ਵਸ਼ਸਹਖ਼-ੜਫ਼ੲ-ੴઅ-��-ઑઓ-નપ-રલળવ-હઽ�ૠૡૹଅ-ଌ��ଓ-ନପ-ରଲଳଵ-ହଽଡ଼�ୟ-ୡୱஃஅ-ஊஎ-�ஒ-கஙசஜஞடணதந-பம-ஹ�అ-ఌఎ-�ఒ-నప-హఽౘ-ౚౠౡಅ-ಌಎ-�ಒ-ನಪ-ಳವ-ಹಽೞೠೡೱೲഅ-ഌഎ-�ഒ-ഺഽൎൟ-ൡൺ-ൿඅ-ඖක-නඳ-රලව-ෆ�-ะาำเ-ๆ�ຂຄງຈຊ�ດ-ທນ-ຟມ-ຣລວສຫອ-ະາຳຽເ-ໄໆໜ-ໟༀཀ-ཇཉ-ཬྈ-ྌက-ဪဿ�-��-�����-��-�ႎႠ-ჅჇ��-ჺჼ-ቈቊ-��-ቖቘቚ-�በ-ኈኊ-��-ኰኲ-ኵኸ-ኾዀዂ-ዅወ-ዖዘ-�ጒ-ጕጘ-�ᎀ-�Ꭰ-��-��-ᙬᙯ-ᙿ�-ᚚᚠ-ᛪᛱ-ᛸᜀ-ᜌᜎ-ᜑᜠ-ᜱ�-��-��-�ក-ឳៗៜᠠ-ᡷᢀ-ᢨᢪᢰ-ᣵᤀ-ᤞ�-ᥭᥰ-ᥴᦀ-ᦫᦰ-ᧉᨀ-ᨖᨠ-ᩔᪧᬅ-ᬳᭅ-ᭋᮃ-ᮠᮮᮯᮺ-ᯥᰀ-ᰣ�-�ᱚ-ᱽᳩ-ᳬᳮ-ᳱᳵᳶᴀ-ᶿḀ-ἕἘ-�ἠ-ὅὈ-��-ὗὙὛ�Ὗ-ώᾀ-ᾴᾶ-ᾼιῂ-ῄῆ-ῌ�-ΐῖ-Ίῠ-Ῥῲ-ῴῶ-ῼ���-ₜℂℇℊ-ℓℕℙ-�ℤΩℨK-ℭℯ-ℹℼ-ℿⅅ-ⅉⅎↃↄⰀ-Ⱞⰰ-ⱞⱠ-ⳤⳫ-ⳮⳲⳳⴀ-ⴥⴧⴭⴰ-ⵧⵯⶀ-ⶖⶠ-ⶦⶨ-ⶮⶰ-ⶶⶸ-ⶾⷀ-ⷆⷈ-ⷎ�-ⷖⷘ-ⷞⸯ々〆〱-〵〻〼�-ゖ�-ゟァ-ヺー-ヿㄅ-ㄭㄱ-ㆎㆠ-ㆺㇰ-ㇿ�-䶵一-鿕ꀀ-ꒌ�-ꓽꔀ-ꘌ�-ꘟꘪꘫꙀ-ꙮꙿ-�ꚠ-ꛥꜗ-ꜟꜢ-ꞈꞋ-ꞭꞰ-ꞷꟷ-�ꠃ-ꠅꠇ-ꠊꠌ-ꠢꡀ-ꡳꢂ-ꢳꣲ-ꣷꣻꣽꤊ-ꤥꤰ-ꥆꥠ-ꥼꦄ-ꦲ�ꧠ-ꧤꧦ-ꧯꧺ-ꧾꨀ-ꨨꩀ-ꩂꩄ-ꩋꩠ-ꩶꩺꩾ-ꪯꪱꪵꪶꪹ-ꪽꫀꫂꫛ-�ꫠ-ꫪꫲ-ꫴ�-ꬆꬉ-ꬎꬑ-ꬖꬠ-ꬦꬨ-ꬮꬰ-ꭚꭜ-ꭥꭰ-ꯢ가-힣ힰ-ퟆퟋ-ퟻ豈-舘並-龎ff-stﬓ-ﬗ�ײַ-ﬨשׁ-זּטּ-לּמּנּ�ףּפּצּ-ﮱﯓ-ﴽ�-�ﶒ-ﷇﷰ-ﷻﹰ-ﹴﹶ-ﻼA-Z�-zヲ-하-ᅦᅧ-�ᅭ-ᅲᅳ-ᅵ0-9٠-٩۰-۹߀-߉०-९০-৯੦-੯૦-૯୦-୯௦-௯౦-౯೦-೯൦-൯෦-෯�-๙�-໙༠-༩�-��-႙០-៩�-᠙᥆-��-᧙᪀-᪉�-᪙�-᭙᮰-᮹᱀-᱉�-᱙꘠-꘩�-꣙꤀-꤉�-꧙꧰-꧹�-꩙꯰-꯹�-9\-]/:
> Range out of order in character class
>
>     at new RegExp (<anonymous>)
>
>     at Object.r (Autolinker.js:1384)
>
>     at Object.<anonymous> (swagger-ui-bundle.js:133)
>
>     at n (bootstrap:19)
>
>     at Object.<anonymous> (linkify.js:11)
>
>     at n (bootstrap:19)
>
>     at Object.<anonymous> (parser_core.js:22)
>
>     at n (bootstrap:19)
>
>     at Object.<anonymous> (index.js:9)
>
>     at n (bootstrap:19)
>
> (index):1 Unchecked runtime.lastError: Could not establish connection. Receiving end does not exist.
>
> (index):61 Uncaught ReferenceError: SwaggerUIBundle is not defined
>
>     at window.onload ((index):61)
>
>  
>
> Mapping for Swagger is working for me[protocol]://[host]:[port]/syncope/swagger/
>
> But Swagger’s functionality doesn’t work.
> I’m still trying to figure out where is an issue.
>
>  
>
> Any ideas why this happens? Haven’t you faced with such an error?
>
> Kind Regards,
> Dmitriy Brashevets
>
>  
>
> *From:* Andrea Patricelli <an...@apache.org>
> *Sent:* Thursday, June 25, 2020 12:33 PM
> *To:* user@syncope.apache.org
> *Subject:* Re: Fwd: How to generate swagger documentation
>
>  
>
> Sorry, my bad.
> The correct swagger url is
>
> [protocol]://[host]:[port]/syncope/swagger/
>
> Best regards,
> Andrea
>
> Il 25/06/20 11:30, Andrea Patricelli ha scritto:
>
>     Hi Anmol
>
>     Il 24/06/20 18:22, Anmol Sharma ha scritto:
>
>         Hi,
>
>          
>
>         I'm a new user exploring the Maven project workflow for Apache Syncope. I tried to use the `syncope-ext-swagger-ui` to generate the swagger documentation.
>
>          
>
>         When I run mvn clean package in the core module, I do not see swagger-ui docs or config generated. I also ran the build with the `all` profile but it did not notice any difference.
>
>          
>
>         I'm wondering if you could point me to some documentation on how to enable / generate swagger docs for a standalone deployment of the core module?
>
>     Her you can find some docs about building Syncope in general [1]. To enable the swagger extension please follow [2], "Enable the Swagger extension" section. You can find swagger docs available at [protocol]://[host]:[port]/syncope-swagger/
>
>          
>
>         Thanks
>
>         anmol
>
>     HTH,
>     Andrea
>
>     [1] https://syncope.apache.org/building
>
>     [2] https://syncope.apache.org/docs/2.1/reference-guide.html#customization-core
>
>          
>
>
>          
>
>         -- 
>
>         - Anmol 
>
>     -- 
>
>     Dott. Andrea Patricelli
>
>     Tel. +39 3204524292
>
>      
>
>     Engineer @ Tirasa S.r.l.
>
>     Viale Vittoria Colonna 97 - 65127 Pescara
>
>     Tel +39 0859116307 / FAX +39 0859111173
>
>     http://www.tirasa.net
>
>      
>
>     Apache Syncope PMC Member
>
> -- 
> Dott. Andrea Patricelli
> Tel. +39 3204524292
>  
> Engineer @ Tirasa S.r.l.
> Viale Vittoria Colonna 97 - 65127 Pescara
> Tel +39 0859116307 / FAX +39 0859111173
> http://www.tirasa.net
>  
> Apache Syncope PMC Member


-- 
Francesco Chicchiriccò

Tirasa - Open Source Excellence
http://www.tirasa.net/

Member at The Apache Software Foundation
Syncope, Cocoon, Olingo, CXF, OpenJPA, PonyMail
http://home.apache.org/~ilgrosso/