Yahoo Bundles

Using Yahoo with Open-Xchange

Preparation

The application keys for yahoo need to be replaced by ones gotten from an application managed at yahoo.

• Go to https://developer.yahoo.com/apps/create/ and sign into Yahoo. It is recommended to use a company-account for this where the credentials are known to more than one person.

• You will see a list of all yahoo-projects associated with the current account. Click "Create a Project" on the right

• Enter a name and description for the yahoo-application in fields "Application Name" and "Description" respectively. Both will be shown to your users when allowing access to Yahoo later.

• Enter the domain of your company website in field "Home Page URL"

• Select "This app requires access to private user data." under "Access Scopes"

• Enter the domain where your Open-Xchange server will run in field "Application Domain". This is important as the Api-Key and -Secret generated later and used with Open-Xchange will only work for this domain.

• Check "Contacts" under "Select APIs for private user data access:"

• Check "I have read and agree to the Yahoo! Developer Network Terms of Use." under "Terms of Use"

• Click "Create Project"

• Enter the value next to "Consumer Key" into file "/opt/openexchange/etc/groupware/yahoooauth.properties" as value for the parameter "com.openexchange.oauth.yahoo.apiKey". Please click the value to highlight the text.

• Enter the value next to "Consumer Secret" into file "/opt/openexchange/etc/groupware/yahoooauth.properties" as value for the parameter "com.openexchange.oauth.yahoo.apiSecret". Please click the value to highlight the text.

• Click "Verify Domain"

• On the next screen click the button "Verify" next to the domain of your application

• Do what is described on screen to verify your domain.

Install on OX App Suite

Debian GNU/Linux 11.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/products/appsuite/stable/backend/DebianBullseye/ /
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/appsuite/stable/backend/updates/DebianBullseye/ /

and run

$ apt-get update
$ apt-get install open-xchange-oauth open-xchange-messaging

Debian GNU/Linux 12.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/products/appsuite/stable/backend/DebianBookworm/ /
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/appsuite/stable/backend/updates/DebianBookworm/ /

and run

$ apt-get update
$ apt-get install open-xchange-oauth open-xchange-messaging

Install on OX AppSuite

Debian GNU/Linux 11.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/products/stable/DebianBullseye/ /
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/stable/updates/DebianBullseye/ /

and run

$ apt-get update
$ apt-get install open-xchange-oauth-yahoo open-xchange-subscribe-yahoo

Debian GNU/Linux 12.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/products/stable/DebianBookworm/ /
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/stable/updates/DebianBookworm/ /

and run

$ apt-get update
$ apt-get install open-xchange-oauth-yahoo open-xchange-subscribe-yahoo

Configuration

If your OX server is reachable only via one host name, you won't have to do anything. If it is reachable by more than one host name, create or open the file "/opt/openexchange/etc/groupware/deferrer.properties" and set the properties therein as such:

com.openexchange.http.deferrer.url=https://mymaindomain.invalid

substituting the value of the property for the domain for which you registered the yahoo-application above (Parameter "Application Domain", see above under Preparation).