Home
Home
German Version
Support
Impressum
22.1 Release ►

    Main Navigation

    • Preparation
      • Connectors
      • Initial Startup for G7 appliances
      • Setup InSpire G7 primary and Standby Appliances
    • Datasources
      • Configuration - Atlassian Confluence Connector
      • Configuration - Best Bets Connector
      • Configuration - COYO Connector
      • Configuration - Data Integration Connector
      • Configuration - Documentum Connector
      • Configuration - Dropbox Connector
      • Configuration - Egnyte Connector
      • Configuration - GitHub Connector
      • Configuration - Google Drive Connector
      • Configuration - GSA Adapter Service
      • Configuration - HL7 Connector
      • Configuration - IBM Connections Connector
      • Configuration - IBM Lotus Connector
      • Configuration - Jira Connector
      • Configuration - JiveSoftware Jive Connector
      • Configuration - JVM Launcher Service
      • Configuration - LDAP Connector
      • Configuration - Microsoft Azure Principal Resolution Service
      • Configuration - Microsoft Dynamics CRM Connector
      • Configuration - Microsoft Exchange Connector
      • Configuration - Microsoft File Connector (Legacy)
      • Configuration - Microsoft File Connector
      • Configuration - Microsoft Graph Connector
      • Configuration - Microsoft Project Connector
      • Configuration - Microsoft SharePoint Connector
      • Configuration - Microsoft Stream Connector
      • Configuration - Microsoft Teams Connector
      • Configuration - Salesforce Connector
      • Configuration - SAP KMC Connector
      • Configuration - SemanticWeb Connector
      • Configuration - ServiceNow Connector
      • Configuration - SharePoint Online Connector
      • Configuration - Sitecore Connector
      • Configuration - Web Connector
      • Configuration - Yammer Connector
      • Data Integration Guide with SQL Database by Example
      • Indexing user-specific properties (Documentum)
      • Installation & Configuration - Atlassian Confluence Sitemap Generator Add-On
      • Installation & Configuration - Caching Principal Resolution Service
      • Installation & Configuration - Jive Sitemap Generator
      • Installation & Configuration - Mindbreeze InSpire Insight Apps in Microsoft SharePoint On-Prem
      • Mindbreeze InSpire Insight Apps in Microsoft SharePoint Online
      • Mindbreeze Web Parts for Microsoft SharePoint
      • User Defined Properties (SharePoint 2013 Connector)
      • Whitepaper - Mindbreeze InSpire Insight Apps in Salesforce
    • Configuration
      • CAS_Authentication
      • Cognito JWT Authentication
      • Configuration - Alternative Search Suggestions and Automatic Search Expansion
      • Configuration - Back-End Credentials
      • Configuration - Chinese Tokenization Plugin (Jieba)
      • Configuration - CJK Tokenizer Plugin
      • Configuration - Collected Results
      • Configuration - CSV Metadata Mapping Item Transformation Service
      • Configuration - Entity Recognition
      • Configuration - Exporting Results
      • Configuration - Filter Plugins
      • Configuration - GSA Late Binding Authentication
      • Configuration - Identity Conversion Service - Replacement Conversion
      • Configuration - Index-Servlets
      • Configuration - Item Property Generator
      • Configuration - Japanese Language Tokenizer
      • Configuration - Kerberos Authentication
      • Configuration - Management Center Menu
      • Configuration - Metadata Enrichment
      • Configuration - Metadata Reference Builder Plugin
      • Configuration - Mindbreeze Proxy Environment (Remote Connector)
      • Configuration - Notifications
      • Configuration - Personalized Relevance
      • Configuration - Plugin Installation
      • Configuration - Principal Validation Plugin
      • Configuration - Profile
      • Configuration - QueryExpr Label Transformer Service
      • Configuration - Reporting Query Logs
      • Configuration - Reporting Query Performance Tests
      • Configuration - Request Header Session Authentication
      • Configuration - Shared Configuration (Windows)
      • Configuration - Vocabularies for Synonyms and Suggest
      • Configuration of Thumbnail Images
      • Cookie-Authentication
      • Documentation - Mindbreeze InSpire
      • I18n Item Transformation
      • Installation & Configuration - Outlook Add-In
      • Installation - GSA Base Configuration Package
      • Language detection - LanguageDetector Plugin
      • Mindbreeze Personalization
      • Mindbreeze Property Expression Language
      • Mindbreeze Query Expression Transformation
      • Non-Inverted Metadata Item Transformer
      • SAML-based Authentication
      • Trusted Peer Authentication for Mindbreeze InSpire
      • Using the InSpire Snapshot for Development in a CI_CD Scenario
      • Whitepaper - SSO with Microsoft AAD or AD FS
      • Whitepaper - Text Classification Insight Services
    • Operations
      • app.telemetry Statistics Regarding Search Queries
      • Configuration - app.telemetry dashboards for usage analysis
      • Configuration Usage Analysis
      • Deletion of Hard Disks
      • Handbook - Backup & Restore
      • Handbook - Command Line Tools
      • Handbook - Distributed Operation (G7)
      • Handbook - Filemanager
      • Handbook - Indexing and Search Logs
      • Handbook - Updates and Downgrades
      • Index Operating Concepts
      • Inspire Diagnostics and Resource Monitoring
      • InSpire Support Documentation
      • Mindbreeze InSpire SFX Update
      • Provision of app.telemetry Information on G7 Appliances via SNMPv3
      • Restoring to As-Delivered Condition
    • User Manual
      • Cheat Sheet
      • iOS App
      • Keyboard Operation
    • SDK
      • api.v2.alertstrigger Interface Description
      • api.v2.export Interface Description
      • api.v2.personalization Interface Description
      • api.v2.search Interface Description
      • api.v2.suggest Interface Description
      • api.v3.admin.SnapshotService Interface Description
      • Debugging (Eclipse)
      • Developing an API V2 search request response transformer
      • Developing Item Transformation and Post Filter Plugins with the Mindbreeze SDK
      • Development of Insight Apps
      • Embedding the Insight App Designer
      • Java API Interface Description
    • Release Notes
      • Release Notes 20.1 Release - Mindbreeze InSpire
      • Release Notes 20.2 Release - Mindbreeze InSpire
      • Release Notes 20.3 Release - Mindbreeze InSpire
      • Release Notes 20.4 Release - Mindbreeze InSpire
      • Release Notes 20.5 Release - Mindbreeze InSpire
      • Release Notes 21.1 Release - Mindbreeze InSpire
      • Release Notes 21.2 Release - Mindbreeze InSpire
      • Release Notes 21.3 Release - Mindbreeze InSpire
      • Release Notes 22.1 Release - Mindbreeze InSpire
    • Security
      • Known Vulnerablities
    • Product Information
      • Product Information - Mindbreeze InSpire - Standby
      • Product Information - Mindbreeze InSpire
    Home

    Path

    Sure, you can handle it. But should you?
    Let our experts manage the tech maintenance while you focus on your business.
    See Consulting Packages

    Yammer Connector

    Installation and Configuration

    Copyright ©

    Mindbreeze GmbH, A-4020 Linz, 2022.

    All rights reserved. All hardware and software names used are brand names and/or trademarks of their respective manufacturers.

    These documents are strictly confidential. The submission and presentation of these documents does not confer any rights to our software, our services and service outcomes, or any other protected rights. The dissemination, publication, or reproduction hereof is prohibited.

    For ease of readability, gender differentiation has been waived. Corresponding terms and definitions apply within the meaning and intent of the principle of equal treatment for both sexes.

    InstallationPermanent link for this heading

    Before installing the Yammer Connector plugin, make sure to verify that the Mindbreeze server is already installed and that this connector is also included in the Mindbreeze license.

    Registering a Mindbreeze app in YammerPermanent link for this heading

    To enable the Mindbreeze Yammer Connector to access Yammer content, a Mindbreeze application needs to be registered in Yammer first. In principle, every Yammer user can register applications.. However, only content that the Yammer user can see will be indexed. It is recommended to create an own Yammer user for the Mindbreeze indexing. This user must then be added to all Yammer groups that are of interest in the indexing process. The result of the registration is an Authorisation Token, which is then used to configure the Mindbreeze Yammer Connector.

    You can register a Mindbreeze application by following the steps below:

    1. Using a web browser, navigate to https://www.yammer.com/client_applications
    2. Make sure that you are logged on with the user ID you want to use for indexing.
    3. Click on “Register new app” and fill out the form. For example:

    Application Name

    mindbreeze-inspire

    Organization

    mycompany

    Support e-mail

    support@mycompany.com

    Website

    https://www.mycompany.com

    Redirect URI

    http://localhost/yammerredirect

    It is important that you select http://localhost/yammerredirect in the “Redirect URI” section, which will make it easier to call up the authorization token.

    Click on “Continue”. Double-check to ensure that the information was entered correctly.

    1. Click on the link “Generate a developer token for this application” below the data of the new application.
    2. Now the fields “Client ID”, “Client Secret”, and “Expected redirect” will be displayed.
    3. In the web browser, navigate to the URL https://www.yammer.com/oauth2/authorize?client_id={{myClientId}}&response_type=code&redirect_uri=http://localhost/yammerredirect and replace {{myClientId}} with your specific “Client ID”.
    4. The web browser will forward you to localhost and display an error message (Connection refused). The address bar of the web browser will show a URL with the following format: http://localhost/yammerredirect?code={{my-auth-code}}, in which {{my-auth-code}} corresponds to your specific authorization code.
    5. Now navigate to the URL https://www.yammer.com/oauth2/access_token.json?client_id={{myClientId}}&client_secret={{myClientSecret}}&code={{myAuthorizationCode}} and replace {{myClientId}} with your specific “Client ID”, replace {{myClientSecret}} with your specific “Client Secret”, and also replace {{myAuthorizationCode}} with your specific authorization code, which you received in the previous step.
    6. The web browser should now display a JSON. You will find the authorization token under access_token -> token. This token is valid indefinitely and is used to configure the Mindbreeze Yammer Connector. (See the “Configuration Options” section.)

    Configuration optionsPermanent link for this heading

    CrawlerPermanent link for this heading

    Option

    Description

    Authorization Token

    The token created during registration for the app (see section “Registering a Mindbreeze app in Yammer”).

    Disable Message Title

    If activated, no titles are set for message-(posts-)documents. If the title is not necessary, this can improve the search relevance compared to other data sources.

    Max File Size (MB)

    Determines the maximum size (in MB) of documents that are indexed. This applies to documents of type "Attachment". Attachments that are too large are skipped.

    Full Crawl Page Size Time Span (Days)

    The Yammer Export API is used for downloading the threads, where a time span can be specified in which period the exported messages / threads have been created. This option can be used to configure the number of days for this time span.

    Include Creator Metadata For Groups

    If name and email address of the creators of the Yammer groups should be indexed as metadata. Active by default. May result in slight performance improvements during indexing the groups if this option is disabled.

    Messages Since (ISO 8601)
    (Advanced Settings)

    Messages older than the configured date are not indexed. The configured date must be in ISO 8601 format (with time zone), e.g. 2010-01-01T00:00:00+00:00

    Read Timeout Minutes
    (Advanced Settings)

    Time in minutes, how long the crawler waits at maximum for API responses.

    Log Paging Requests To CSV
    (Advanced Settings)

    When enabled, all API requests to Yammer that use paging are logged in a separate .csv log file. This option should only be used for troubleshooting in case of issues.

    Enable Delta Crawling

    If active, only new messages (including attachments) from Yammer are indexed during a crawl run. However, groups will still be crawled completely. Note that deleted messages cannot be detected during a delta crawl run. Please make sure that you activate a "Full Crawl Schedule" so that deleted messages are also handled.

    Full Crawl Schedule

    If the entered extended cron expression is triggered, the next crawl run will be a full crawl run (instead of a delta crawl run). Only effective if "Enable Delta Crawling" is active. Documentation and examples of Cron Expressions can be found here.

    Principal Resolution ServicePermanent link for this heading

    Option

    Description

    Authorization Token

    The token created during registration for the app (see section Registering a Mindbreeze app in Yammer).

    TroubleshootingPermanent link for this heading

    403 ForbiddenPermanent link for this heading

    If you notice errors of this type in the crawler or principal resolution service log:

    Error on requesting url: 'https://www.yammer.com/api/v1/groups/123456/members.json' status: 403 responseContent: 'Forbidden'

    Then this indicates a permission problem with the Yammer user used for crawling. A possible solution to this problem is to change the "Content Mode". To do this, navigate to the "Network Admin" settings in Yammer under "Edit network admin settings" and then "Content Mode" under "Content and Security". Select "Private Content Mode". This allows the crawler to access all necessary APIs so that, for example, user groups and permissions can be mapped correctly. Repeat the crawl run or the Principal Resolution Service update, there should now be no more "403 Forbidden" errors.

    Important note: The Mindbreeze Yammer Connector does not index private Yammer messages (regardless of the "Content and Security" setting). All messages are checked, private messages are explicitly ignored and not indexed.

    Download PDF

    • Configuration - Yammer Connector

    Content

    • Installation
    • Registering a Mindbreeze app in Yammer
    • Configuration options
    • Troubleshooting

    Download PDF

    • Configuration - Yammer Connector